inode.c 45 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600
  1. /*
  2. * linux/fs/nfs/inode.c
  3. *
  4. * Copyright (C) 1992 Rick Sladkey
  5. *
  6. * nfs inode and superblock handling functions
  7. *
  8. * Modularised by Alan Cox <alan@lxorguk.ukuu.org.uk>, while hacking some
  9. * experimental NFS changes. Modularisation taken straight from SYS5 fs.
  10. *
  11. * Change to nfs_read_super() to permit NFS mounts to multi-homed hosts.
  12. * J.S.Peatfield@damtp.cam.ac.uk
  13. *
  14. */
  15. #include <linux/module.h>
  16. #include <linux/init.h>
  17. #include <linux/sched.h>
  18. #include <linux/time.h>
  19. #include <linux/kernel.h>
  20. #include <linux/mm.h>
  21. #include <linux/string.h>
  22. #include <linux/stat.h>
  23. #include <linux/errno.h>
  24. #include <linux/unistd.h>
  25. #include <linux/sunrpc/clnt.h>
  26. #include <linux/sunrpc/stats.h>
  27. #include <linux/sunrpc/metrics.h>
  28. #include <linux/nfs_fs.h>
  29. #include <linux/nfs_mount.h>
  30. #include <linux/nfs4_mount.h>
  31. #include <linux/lockd/bind.h>
  32. #include <linux/seq_file.h>
  33. #include <linux/mount.h>
  34. #include <linux/nfs_idmap.h>
  35. #include <linux/vfs.h>
  36. #include <linux/inet.h>
  37. #include <linux/nfs_xdr.h>
  38. #include <asm/system.h>
  39. #include <asm/uaccess.h>
  40. #include "nfs4_fs.h"
  41. #include "callback.h"
  42. #include "delegation.h"
  43. #include "iostat.h"
  44. #include "internal.h"
  45. #include "fscache.h"
  46. #include "dns_resolve.h"
  47. #define NFSDBG_FACILITY NFSDBG_VFS
  48. #define NFS_64_BIT_INODE_NUMBERS_ENABLED 1
  49. /* Default is to see 64-bit inode numbers */
  50. static int enable_ino64 = NFS_64_BIT_INODE_NUMBERS_ENABLED;
  51. static void nfs_invalidate_inode(struct inode *);
  52. static int nfs_update_inode(struct inode *, struct nfs_fattr *);
  53. static struct kmem_cache * nfs_inode_cachep;
  54. static inline unsigned long
  55. nfs_fattr_to_ino_t(struct nfs_fattr *fattr)
  56. {
  57. return nfs_fileid_to_ino_t(fattr->fileid);
  58. }
  59. /**
  60. * nfs_wait_bit_killable - helper for functions that are sleeping on bit locks
  61. * @word: long word containing the bit lock
  62. */
  63. int nfs_wait_bit_killable(void *word)
  64. {
  65. if (fatal_signal_pending(current))
  66. return -ERESTARTSYS;
  67. schedule();
  68. return 0;
  69. }
  70. /**
  71. * nfs_compat_user_ino64 - returns the user-visible inode number
  72. * @fileid: 64-bit fileid
  73. *
  74. * This function returns a 32-bit inode number if the boot parameter
  75. * nfs.enable_ino64 is zero.
  76. */
  77. u64 nfs_compat_user_ino64(u64 fileid)
  78. {
  79. int ino;
  80. if (enable_ino64)
  81. return fileid;
  82. ino = fileid;
  83. if (sizeof(ino) < sizeof(fileid))
  84. ino ^= fileid >> (sizeof(fileid)-sizeof(ino)) * 8;
  85. return ino;
  86. }
  87. int nfs_write_inode(struct inode *inode, int sync)
  88. {
  89. int ret;
  90. if (sync) {
  91. ret = filemap_fdatawait(inode->i_mapping);
  92. if (ret == 0)
  93. ret = nfs_commit_inode(inode, FLUSH_SYNC);
  94. } else
  95. ret = nfs_commit_inode(inode, 0);
  96. if (ret >= 0)
  97. return 0;
  98. __mark_inode_dirty(inode, I_DIRTY_DATASYNC);
  99. return ret;
  100. }
  101. void nfs_clear_inode(struct inode *inode)
  102. {
  103. /*
  104. * The following should never happen...
  105. */
  106. BUG_ON(nfs_have_writebacks(inode));
  107. BUG_ON(!list_empty(&NFS_I(inode)->open_files));
  108. nfs_zap_acl_cache(inode);
  109. nfs_access_zap_cache(inode);
  110. nfs_fscache_release_inode_cookie(inode);
  111. }
  112. /**
  113. * nfs_sync_mapping - helper to flush all mmapped dirty data to disk
  114. */
  115. int nfs_sync_mapping(struct address_space *mapping)
  116. {
  117. int ret;
  118. if (mapping->nrpages == 0)
  119. return 0;
  120. unmap_mapping_range(mapping, 0, 0, 0);
  121. ret = filemap_write_and_wait(mapping);
  122. if (ret != 0)
  123. goto out;
  124. ret = nfs_wb_all(mapping->host);
  125. out:
  126. return ret;
  127. }
  128. /*
  129. * Invalidate the local caches
  130. */
  131. static void nfs_zap_caches_locked(struct inode *inode)
  132. {
  133. struct nfs_inode *nfsi = NFS_I(inode);
  134. int mode = inode->i_mode;
  135. nfs_inc_stats(inode, NFSIOS_ATTRINVALIDATE);
  136. nfsi->attrtimeo = NFS_MINATTRTIMEO(inode);
  137. nfsi->attrtimeo_timestamp = jiffies;
  138. memset(NFS_COOKIEVERF(inode), 0, sizeof(NFS_COOKIEVERF(inode)));
  139. if (S_ISREG(mode) || S_ISDIR(mode) || S_ISLNK(mode))
  140. nfsi->cache_validity |= NFS_INO_INVALID_ATTR|NFS_INO_INVALID_DATA|NFS_INO_INVALID_ACCESS|NFS_INO_INVALID_ACL|NFS_INO_REVAL_PAGECACHE;
  141. else
  142. nfsi->cache_validity |= NFS_INO_INVALID_ATTR|NFS_INO_INVALID_ACCESS|NFS_INO_INVALID_ACL|NFS_INO_REVAL_PAGECACHE;
  143. }
  144. void nfs_zap_caches(struct inode *inode)
  145. {
  146. spin_lock(&inode->i_lock);
  147. nfs_zap_caches_locked(inode);
  148. spin_unlock(&inode->i_lock);
  149. }
  150. void nfs_zap_mapping(struct inode *inode, struct address_space *mapping)
  151. {
  152. if (mapping->nrpages != 0) {
  153. spin_lock(&inode->i_lock);
  154. NFS_I(inode)->cache_validity |= NFS_INO_INVALID_DATA;
  155. spin_unlock(&inode->i_lock);
  156. }
  157. }
  158. void nfs_zap_acl_cache(struct inode *inode)
  159. {
  160. void (*clear_acl_cache)(struct inode *);
  161. clear_acl_cache = NFS_PROTO(inode)->clear_acl_cache;
  162. if (clear_acl_cache != NULL)
  163. clear_acl_cache(inode);
  164. spin_lock(&inode->i_lock);
  165. NFS_I(inode)->cache_validity &= ~NFS_INO_INVALID_ACL;
  166. spin_unlock(&inode->i_lock);
  167. }
  168. void nfs_invalidate_atime(struct inode *inode)
  169. {
  170. spin_lock(&inode->i_lock);
  171. NFS_I(inode)->cache_validity |= NFS_INO_INVALID_ATIME;
  172. spin_unlock(&inode->i_lock);
  173. }
  174. /*
  175. * Invalidate, but do not unhash, the inode.
  176. * NB: must be called with inode->i_lock held!
  177. */
  178. static void nfs_invalidate_inode(struct inode *inode)
  179. {
  180. set_bit(NFS_INO_STALE, &NFS_I(inode)->flags);
  181. nfs_zap_caches_locked(inode);
  182. }
  183. struct nfs_find_desc {
  184. struct nfs_fh *fh;
  185. struct nfs_fattr *fattr;
  186. };
  187. /*
  188. * In NFSv3 we can have 64bit inode numbers. In order to support
  189. * this, and re-exported directories (also seen in NFSv2)
  190. * we are forced to allow 2 different inodes to have the same
  191. * i_ino.
  192. */
  193. static int
  194. nfs_find_actor(struct inode *inode, void *opaque)
  195. {
  196. struct nfs_find_desc *desc = (struct nfs_find_desc *)opaque;
  197. struct nfs_fh *fh = desc->fh;
  198. struct nfs_fattr *fattr = desc->fattr;
  199. if (NFS_FILEID(inode) != fattr->fileid)
  200. return 0;
  201. if (nfs_compare_fh(NFS_FH(inode), fh))
  202. return 0;
  203. if (is_bad_inode(inode) || NFS_STALE(inode))
  204. return 0;
  205. return 1;
  206. }
  207. static int
  208. nfs_init_locked(struct inode *inode, void *opaque)
  209. {
  210. struct nfs_find_desc *desc = (struct nfs_find_desc *)opaque;
  211. struct nfs_fattr *fattr = desc->fattr;
  212. set_nfs_fileid(inode, fattr->fileid);
  213. nfs_copy_fh(NFS_FH(inode), desc->fh);
  214. return 0;
  215. }
  216. /* Don't use READDIRPLUS on directories that we believe are too large */
  217. #define NFS_LIMIT_READDIRPLUS (8*PAGE_SIZE)
  218. /*
  219. * This is our front-end to iget that looks up inodes by file handle
  220. * instead of inode number.
  221. */
  222. struct inode *
  223. nfs_fhget(struct super_block *sb, struct nfs_fh *fh, struct nfs_fattr *fattr)
  224. {
  225. struct nfs_find_desc desc = {
  226. .fh = fh,
  227. .fattr = fattr
  228. };
  229. struct inode *inode = ERR_PTR(-ENOENT);
  230. unsigned long hash;
  231. if ((fattr->valid & NFS_ATTR_FATTR_FILEID) == 0)
  232. goto out_no_inode;
  233. if ((fattr->valid & NFS_ATTR_FATTR_TYPE) == 0)
  234. goto out_no_inode;
  235. hash = nfs_fattr_to_ino_t(fattr);
  236. inode = iget5_locked(sb, hash, nfs_find_actor, nfs_init_locked, &desc);
  237. if (inode == NULL) {
  238. inode = ERR_PTR(-ENOMEM);
  239. goto out_no_inode;
  240. }
  241. if (inode->i_state & I_NEW) {
  242. struct nfs_inode *nfsi = NFS_I(inode);
  243. unsigned long now = jiffies;
  244. /* We set i_ino for the few things that still rely on it,
  245. * such as stat(2) */
  246. inode->i_ino = hash;
  247. /* We can't support update_atime(), since the server will reset it */
  248. inode->i_flags |= S_NOATIME|S_NOCMTIME;
  249. inode->i_mode = fattr->mode;
  250. if ((fattr->valid & NFS_ATTR_FATTR_MODE) == 0
  251. && nfs_server_capable(inode, NFS_CAP_MODE))
  252. nfsi->cache_validity |= NFS_INO_INVALID_ATTR
  253. | NFS_INO_INVALID_ACCESS
  254. | NFS_INO_INVALID_ACL;
  255. /* Why so? Because we want revalidate for devices/FIFOs, and
  256. * that's precisely what we have in nfs_file_inode_operations.
  257. */
  258. inode->i_op = NFS_SB(sb)->nfs_client->rpc_ops->file_inode_ops;
  259. if (S_ISREG(inode->i_mode)) {
  260. inode->i_fop = &nfs_file_operations;
  261. inode->i_data.a_ops = &nfs_file_aops;
  262. inode->i_data.backing_dev_info = &NFS_SB(sb)->backing_dev_info;
  263. } else if (S_ISDIR(inode->i_mode)) {
  264. inode->i_op = NFS_SB(sb)->nfs_client->rpc_ops->dir_inode_ops;
  265. inode->i_fop = &nfs_dir_operations;
  266. if (nfs_server_capable(inode, NFS_CAP_READDIRPLUS)
  267. && fattr->size <= NFS_LIMIT_READDIRPLUS)
  268. set_bit(NFS_INO_ADVISE_RDPLUS, &NFS_I(inode)->flags);
  269. /* Deal with crossing mountpoints */
  270. if ((fattr->valid & NFS_ATTR_FATTR_FSID)
  271. && !nfs_fsid_equal(&NFS_SB(sb)->fsid, &fattr->fsid)) {
  272. if (fattr->valid & NFS_ATTR_FATTR_V4_REFERRAL)
  273. inode->i_op = &nfs_referral_inode_operations;
  274. else
  275. inode->i_op = &nfs_mountpoint_inode_operations;
  276. inode->i_fop = NULL;
  277. set_bit(NFS_INO_MOUNTPOINT, &nfsi->flags);
  278. }
  279. } else if (S_ISLNK(inode->i_mode))
  280. inode->i_op = &nfs_symlink_inode_operations;
  281. else
  282. init_special_inode(inode, inode->i_mode, fattr->rdev);
  283. memset(&inode->i_atime, 0, sizeof(inode->i_atime));
  284. memset(&inode->i_mtime, 0, sizeof(inode->i_mtime));
  285. memset(&inode->i_ctime, 0, sizeof(inode->i_ctime));
  286. nfsi->change_attr = 0;
  287. inode->i_size = 0;
  288. inode->i_nlink = 0;
  289. inode->i_uid = -2;
  290. inode->i_gid = -2;
  291. inode->i_blocks = 0;
  292. memset(nfsi->cookieverf, 0, sizeof(nfsi->cookieverf));
  293. nfsi->read_cache_jiffies = fattr->time_start;
  294. nfsi->attr_gencount = fattr->gencount;
  295. if (fattr->valid & NFS_ATTR_FATTR_ATIME)
  296. inode->i_atime = fattr->atime;
  297. else if (nfs_server_capable(inode, NFS_CAP_ATIME))
  298. nfsi->cache_validity |= NFS_INO_INVALID_ATTR;
  299. if (fattr->valid & NFS_ATTR_FATTR_MTIME)
  300. inode->i_mtime = fattr->mtime;
  301. else if (nfs_server_capable(inode, NFS_CAP_MTIME))
  302. nfsi->cache_validity |= NFS_INO_INVALID_ATTR
  303. | NFS_INO_INVALID_DATA;
  304. if (fattr->valid & NFS_ATTR_FATTR_CTIME)
  305. inode->i_ctime = fattr->ctime;
  306. else if (nfs_server_capable(inode, NFS_CAP_CTIME))
  307. nfsi->cache_validity |= NFS_INO_INVALID_ATTR
  308. | NFS_INO_INVALID_ACCESS
  309. | NFS_INO_INVALID_ACL;
  310. if (fattr->valid & NFS_ATTR_FATTR_CHANGE)
  311. nfsi->change_attr = fattr->change_attr;
  312. else if (nfs_server_capable(inode, NFS_CAP_CHANGE_ATTR))
  313. nfsi->cache_validity |= NFS_INO_INVALID_ATTR
  314. | NFS_INO_INVALID_DATA;
  315. if (fattr->valid & NFS_ATTR_FATTR_SIZE)
  316. inode->i_size = nfs_size_to_loff_t(fattr->size);
  317. else
  318. nfsi->cache_validity |= NFS_INO_INVALID_ATTR
  319. | NFS_INO_INVALID_DATA
  320. | NFS_INO_REVAL_PAGECACHE;
  321. if (fattr->valid & NFS_ATTR_FATTR_NLINK)
  322. inode->i_nlink = fattr->nlink;
  323. else if (nfs_server_capable(inode, NFS_CAP_NLINK))
  324. nfsi->cache_validity |= NFS_INO_INVALID_ATTR;
  325. if (fattr->valid & NFS_ATTR_FATTR_OWNER)
  326. inode->i_uid = fattr->uid;
  327. else if (nfs_server_capable(inode, NFS_CAP_OWNER))
  328. nfsi->cache_validity |= NFS_INO_INVALID_ATTR
  329. | NFS_INO_INVALID_ACCESS
  330. | NFS_INO_INVALID_ACL;
  331. if (fattr->valid & NFS_ATTR_FATTR_GROUP)
  332. inode->i_gid = fattr->gid;
  333. else if (nfs_server_capable(inode, NFS_CAP_OWNER_GROUP))
  334. nfsi->cache_validity |= NFS_INO_INVALID_ATTR
  335. | NFS_INO_INVALID_ACCESS
  336. | NFS_INO_INVALID_ACL;
  337. if (fattr->valid & NFS_ATTR_FATTR_BLOCKS_USED)
  338. inode->i_blocks = fattr->du.nfs2.blocks;
  339. if (fattr->valid & NFS_ATTR_FATTR_SPACE_USED) {
  340. /*
  341. * report the blocks in 512byte units
  342. */
  343. inode->i_blocks = nfs_calc_block_size(fattr->du.nfs3.used);
  344. }
  345. nfsi->attrtimeo = NFS_MINATTRTIMEO(inode);
  346. nfsi->attrtimeo_timestamp = now;
  347. nfsi->access_cache = RB_ROOT;
  348. nfs_fscache_init_inode_cookie(inode);
  349. unlock_new_inode(inode);
  350. } else
  351. nfs_refresh_inode(inode, fattr);
  352. dprintk("NFS: nfs_fhget(%s/%Ld ct=%d)\n",
  353. inode->i_sb->s_id,
  354. (long long)NFS_FILEID(inode),
  355. atomic_read(&inode->i_count));
  356. out:
  357. return inode;
  358. out_no_inode:
  359. dprintk("nfs_fhget: iget failed with error %ld\n", PTR_ERR(inode));
  360. goto out;
  361. }
  362. #define NFS_VALID_ATTRS (ATTR_MODE|ATTR_UID|ATTR_GID|ATTR_SIZE|ATTR_ATIME|ATTR_ATIME_SET|ATTR_MTIME|ATTR_MTIME_SET|ATTR_FILE)
  363. int
  364. nfs_setattr(struct dentry *dentry, struct iattr *attr)
  365. {
  366. struct inode *inode = dentry->d_inode;
  367. struct nfs_fattr fattr;
  368. int error;
  369. nfs_inc_stats(inode, NFSIOS_VFSSETATTR);
  370. /* skip mode change if it's just for clearing setuid/setgid */
  371. if (attr->ia_valid & (ATTR_KILL_SUID | ATTR_KILL_SGID))
  372. attr->ia_valid &= ~ATTR_MODE;
  373. if (attr->ia_valid & ATTR_SIZE) {
  374. if (!S_ISREG(inode->i_mode) || attr->ia_size == i_size_read(inode))
  375. attr->ia_valid &= ~ATTR_SIZE;
  376. }
  377. /* Optimization: if the end result is no change, don't RPC */
  378. attr->ia_valid &= NFS_VALID_ATTRS;
  379. if ((attr->ia_valid & ~ATTR_FILE) == 0)
  380. return 0;
  381. /* Write all dirty data */
  382. if (S_ISREG(inode->i_mode)) {
  383. filemap_write_and_wait(inode->i_mapping);
  384. nfs_wb_all(inode);
  385. }
  386. /*
  387. * Return any delegations if we're going to change ACLs
  388. */
  389. if ((attr->ia_valid & (ATTR_MODE|ATTR_UID|ATTR_GID)) != 0)
  390. nfs_inode_return_delegation(inode);
  391. error = NFS_PROTO(inode)->setattr(dentry, &fattr, attr);
  392. if (error == 0)
  393. nfs_refresh_inode(inode, &fattr);
  394. return error;
  395. }
  396. /**
  397. * nfs_vmtruncate - unmap mappings "freed" by truncate() syscall
  398. * @inode: inode of the file used
  399. * @offset: file offset to start truncating
  400. *
  401. * This is a copy of the common vmtruncate, but with the locking
  402. * corrected to take into account the fact that NFS requires
  403. * inode->i_size to be updated under the inode->i_lock.
  404. */
  405. static int nfs_vmtruncate(struct inode * inode, loff_t offset)
  406. {
  407. if (i_size_read(inode) < offset) {
  408. unsigned long limit;
  409. limit = current->signal->rlim[RLIMIT_FSIZE].rlim_cur;
  410. if (limit != RLIM_INFINITY && offset > limit)
  411. goto out_sig;
  412. if (offset > inode->i_sb->s_maxbytes)
  413. goto out_big;
  414. spin_lock(&inode->i_lock);
  415. i_size_write(inode, offset);
  416. spin_unlock(&inode->i_lock);
  417. } else {
  418. struct address_space *mapping = inode->i_mapping;
  419. /*
  420. * truncation of in-use swapfiles is disallowed - it would
  421. * cause subsequent swapout to scribble on the now-freed
  422. * blocks.
  423. */
  424. if (IS_SWAPFILE(inode))
  425. return -ETXTBSY;
  426. spin_lock(&inode->i_lock);
  427. i_size_write(inode, offset);
  428. spin_unlock(&inode->i_lock);
  429. /*
  430. * unmap_mapping_range is called twice, first simply for
  431. * efficiency so that truncate_inode_pages does fewer
  432. * single-page unmaps. However after this first call, and
  433. * before truncate_inode_pages finishes, it is possible for
  434. * private pages to be COWed, which remain after
  435. * truncate_inode_pages finishes, hence the second
  436. * unmap_mapping_range call must be made for correctness.
  437. */
  438. unmap_mapping_range(mapping, offset + PAGE_SIZE - 1, 0, 1);
  439. truncate_inode_pages(mapping, offset);
  440. unmap_mapping_range(mapping, offset + PAGE_SIZE - 1, 0, 1);
  441. }
  442. return 0;
  443. out_sig:
  444. send_sig(SIGXFSZ, current, 0);
  445. out_big:
  446. return -EFBIG;
  447. }
  448. /**
  449. * nfs_setattr_update_inode - Update inode metadata after a setattr call.
  450. * @inode: pointer to struct inode
  451. * @attr: pointer to struct iattr
  452. *
  453. * Note: we do this in the *proc.c in order to ensure that
  454. * it works for things like exclusive creates too.
  455. */
  456. void nfs_setattr_update_inode(struct inode *inode, struct iattr *attr)
  457. {
  458. if ((attr->ia_valid & (ATTR_MODE|ATTR_UID|ATTR_GID)) != 0) {
  459. spin_lock(&inode->i_lock);
  460. if ((attr->ia_valid & ATTR_MODE) != 0) {
  461. int mode = attr->ia_mode & S_IALLUGO;
  462. mode |= inode->i_mode & ~S_IALLUGO;
  463. inode->i_mode = mode;
  464. }
  465. if ((attr->ia_valid & ATTR_UID) != 0)
  466. inode->i_uid = attr->ia_uid;
  467. if ((attr->ia_valid & ATTR_GID) != 0)
  468. inode->i_gid = attr->ia_gid;
  469. NFS_I(inode)->cache_validity |= NFS_INO_INVALID_ACCESS|NFS_INO_INVALID_ACL;
  470. spin_unlock(&inode->i_lock);
  471. }
  472. if ((attr->ia_valid & ATTR_SIZE) != 0) {
  473. nfs_inc_stats(inode, NFSIOS_SETATTRTRUNC);
  474. nfs_vmtruncate(inode, attr->ia_size);
  475. }
  476. }
  477. int nfs_getattr(struct vfsmount *mnt, struct dentry *dentry, struct kstat *stat)
  478. {
  479. struct inode *inode = dentry->d_inode;
  480. int need_atime = NFS_I(inode)->cache_validity & NFS_INO_INVALID_ATIME;
  481. int err;
  482. /*
  483. * Flush out writes to the server in order to update c/mtime.
  484. *
  485. * Hold the i_mutex to suspend application writes temporarily;
  486. * this prevents long-running writing applications from blocking
  487. * nfs_wb_nocommit.
  488. */
  489. if (S_ISREG(inode->i_mode)) {
  490. mutex_lock(&inode->i_mutex);
  491. nfs_wb_nocommit(inode);
  492. mutex_unlock(&inode->i_mutex);
  493. }
  494. /*
  495. * We may force a getattr if the user cares about atime.
  496. *
  497. * Note that we only have to check the vfsmount flags here:
  498. * - NFS always sets S_NOATIME by so checking it would give a
  499. * bogus result
  500. * - NFS never sets MS_NOATIME or MS_NODIRATIME so there is
  501. * no point in checking those.
  502. */
  503. if ((mnt->mnt_flags & MNT_NOATIME) ||
  504. ((mnt->mnt_flags & MNT_NODIRATIME) && S_ISDIR(inode->i_mode)))
  505. need_atime = 0;
  506. if (need_atime)
  507. err = __nfs_revalidate_inode(NFS_SERVER(inode), inode);
  508. else
  509. err = nfs_revalidate_inode(NFS_SERVER(inode), inode);
  510. if (!err) {
  511. generic_fillattr(inode, stat);
  512. stat->ino = nfs_compat_user_ino64(NFS_FILEID(inode));
  513. }
  514. return err;
  515. }
  516. /**
  517. * nfs_close_context - Common close_context() routine NFSv2/v3
  518. * @ctx: pointer to context
  519. * @is_sync: is this a synchronous close
  520. *
  521. * always ensure that the attributes are up to date if we're mounted
  522. * with close-to-open semantics
  523. */
  524. void nfs_close_context(struct nfs_open_context *ctx, int is_sync)
  525. {
  526. struct inode *inode;
  527. struct nfs_server *server;
  528. if (!(ctx->mode & FMODE_WRITE))
  529. return;
  530. if (!is_sync)
  531. return;
  532. inode = ctx->path.dentry->d_inode;
  533. if (!list_empty(&NFS_I(inode)->open_files))
  534. return;
  535. server = NFS_SERVER(inode);
  536. if (server->flags & NFS_MOUNT_NOCTO)
  537. return;
  538. nfs_revalidate_inode(server, inode);
  539. }
  540. static struct nfs_open_context *alloc_nfs_open_context(struct vfsmount *mnt, struct dentry *dentry, struct rpc_cred *cred)
  541. {
  542. struct nfs_open_context *ctx;
  543. ctx = kmalloc(sizeof(*ctx), GFP_KERNEL);
  544. if (ctx != NULL) {
  545. ctx->path.dentry = dget(dentry);
  546. ctx->path.mnt = mntget(mnt);
  547. ctx->cred = get_rpccred(cred);
  548. ctx->state = NULL;
  549. ctx->lockowner = current->files;
  550. ctx->flags = 0;
  551. ctx->error = 0;
  552. ctx->dir_cookie = 0;
  553. atomic_set(&ctx->count, 1);
  554. }
  555. return ctx;
  556. }
  557. struct nfs_open_context *get_nfs_open_context(struct nfs_open_context *ctx)
  558. {
  559. if (ctx != NULL)
  560. atomic_inc(&ctx->count);
  561. return ctx;
  562. }
  563. static void __put_nfs_open_context(struct nfs_open_context *ctx, int is_sync)
  564. {
  565. struct inode *inode = ctx->path.dentry->d_inode;
  566. if (!atomic_dec_and_lock(&ctx->count, &inode->i_lock))
  567. return;
  568. list_del(&ctx->list);
  569. spin_unlock(&inode->i_lock);
  570. NFS_PROTO(inode)->close_context(ctx, is_sync);
  571. if (ctx->cred != NULL)
  572. put_rpccred(ctx->cred);
  573. path_put(&ctx->path);
  574. kfree(ctx);
  575. }
  576. void put_nfs_open_context(struct nfs_open_context *ctx)
  577. {
  578. __put_nfs_open_context(ctx, 0);
  579. }
  580. static void put_nfs_open_context_sync(struct nfs_open_context *ctx)
  581. {
  582. __put_nfs_open_context(ctx, 1);
  583. }
  584. /*
  585. * Ensure that mmap has a recent RPC credential for use when writing out
  586. * shared pages
  587. */
  588. static void nfs_file_set_open_context(struct file *filp, struct nfs_open_context *ctx)
  589. {
  590. struct inode *inode = filp->f_path.dentry->d_inode;
  591. struct nfs_inode *nfsi = NFS_I(inode);
  592. filp->private_data = get_nfs_open_context(ctx);
  593. spin_lock(&inode->i_lock);
  594. list_add(&ctx->list, &nfsi->open_files);
  595. spin_unlock(&inode->i_lock);
  596. }
  597. /*
  598. * Given an inode, search for an open context with the desired characteristics
  599. */
  600. struct nfs_open_context *nfs_find_open_context(struct inode *inode, struct rpc_cred *cred, fmode_t mode)
  601. {
  602. struct nfs_inode *nfsi = NFS_I(inode);
  603. struct nfs_open_context *pos, *ctx = NULL;
  604. spin_lock(&inode->i_lock);
  605. list_for_each_entry(pos, &nfsi->open_files, list) {
  606. if (cred != NULL && pos->cred != cred)
  607. continue;
  608. if ((pos->mode & mode) == mode) {
  609. ctx = get_nfs_open_context(pos);
  610. break;
  611. }
  612. }
  613. spin_unlock(&inode->i_lock);
  614. return ctx;
  615. }
  616. static void nfs_file_clear_open_context(struct file *filp)
  617. {
  618. struct inode *inode = filp->f_path.dentry->d_inode;
  619. struct nfs_open_context *ctx = nfs_file_open_context(filp);
  620. if (ctx) {
  621. filp->private_data = NULL;
  622. spin_lock(&inode->i_lock);
  623. list_move_tail(&ctx->list, &NFS_I(inode)->open_files);
  624. spin_unlock(&inode->i_lock);
  625. put_nfs_open_context_sync(ctx);
  626. }
  627. }
  628. /*
  629. * These allocate and release file read/write context information.
  630. */
  631. int nfs_open(struct inode *inode, struct file *filp)
  632. {
  633. struct nfs_open_context *ctx;
  634. struct rpc_cred *cred;
  635. cred = rpc_lookup_cred();
  636. if (IS_ERR(cred))
  637. return PTR_ERR(cred);
  638. ctx = alloc_nfs_open_context(filp->f_path.mnt, filp->f_path.dentry, cred);
  639. put_rpccred(cred);
  640. if (ctx == NULL)
  641. return -ENOMEM;
  642. ctx->mode = filp->f_mode;
  643. nfs_file_set_open_context(filp, ctx);
  644. put_nfs_open_context(ctx);
  645. nfs_fscache_set_inode_cookie(inode, filp);
  646. return 0;
  647. }
  648. int nfs_release(struct inode *inode, struct file *filp)
  649. {
  650. nfs_file_clear_open_context(filp);
  651. return 0;
  652. }
  653. /*
  654. * This function is called whenever some part of NFS notices that
  655. * the cached attributes have to be refreshed.
  656. */
  657. int
  658. __nfs_revalidate_inode(struct nfs_server *server, struct inode *inode)
  659. {
  660. int status = -ESTALE;
  661. struct nfs_fattr fattr;
  662. struct nfs_inode *nfsi = NFS_I(inode);
  663. dfprintk(PAGECACHE, "NFS: revalidating (%s/%Ld)\n",
  664. inode->i_sb->s_id, (long long)NFS_FILEID(inode));
  665. if (is_bad_inode(inode))
  666. goto out;
  667. if (NFS_STALE(inode))
  668. goto out;
  669. nfs_inc_stats(inode, NFSIOS_INODEREVALIDATE);
  670. status = NFS_PROTO(inode)->getattr(server, NFS_FH(inode), &fattr);
  671. if (status != 0) {
  672. dfprintk(PAGECACHE, "nfs_revalidate_inode: (%s/%Ld) getattr failed, error=%d\n",
  673. inode->i_sb->s_id,
  674. (long long)NFS_FILEID(inode), status);
  675. if (status == -ESTALE) {
  676. nfs_zap_caches(inode);
  677. if (!S_ISDIR(inode->i_mode))
  678. set_bit(NFS_INO_STALE, &NFS_I(inode)->flags);
  679. }
  680. goto out;
  681. }
  682. status = nfs_refresh_inode(inode, &fattr);
  683. if (status) {
  684. dfprintk(PAGECACHE, "nfs_revalidate_inode: (%s/%Ld) refresh failed, error=%d\n",
  685. inode->i_sb->s_id,
  686. (long long)NFS_FILEID(inode), status);
  687. goto out;
  688. }
  689. if (nfsi->cache_validity & NFS_INO_INVALID_ACL)
  690. nfs_zap_acl_cache(inode);
  691. dfprintk(PAGECACHE, "NFS: (%s/%Ld) revalidation complete\n",
  692. inode->i_sb->s_id,
  693. (long long)NFS_FILEID(inode));
  694. out:
  695. return status;
  696. }
  697. int nfs_attribute_timeout(struct inode *inode)
  698. {
  699. struct nfs_inode *nfsi = NFS_I(inode);
  700. if (nfs_have_delegation(inode, FMODE_READ))
  701. return 0;
  702. return !time_in_range_open(jiffies, nfsi->read_cache_jiffies, nfsi->read_cache_jiffies + nfsi->attrtimeo);
  703. }
  704. /**
  705. * nfs_revalidate_inode - Revalidate the inode attributes
  706. * @server - pointer to nfs_server struct
  707. * @inode - pointer to inode struct
  708. *
  709. * Updates inode attribute information by retrieving the data from the server.
  710. */
  711. int nfs_revalidate_inode(struct nfs_server *server, struct inode *inode)
  712. {
  713. if (!(NFS_I(inode)->cache_validity & NFS_INO_INVALID_ATTR)
  714. && !nfs_attribute_timeout(inode))
  715. return NFS_STALE(inode) ? -ESTALE : 0;
  716. return __nfs_revalidate_inode(server, inode);
  717. }
  718. static int nfs_invalidate_mapping_nolock(struct inode *inode, struct address_space *mapping)
  719. {
  720. struct nfs_inode *nfsi = NFS_I(inode);
  721. if (mapping->nrpages != 0) {
  722. int ret = invalidate_inode_pages2(mapping);
  723. if (ret < 0)
  724. return ret;
  725. }
  726. spin_lock(&inode->i_lock);
  727. nfsi->cache_validity &= ~NFS_INO_INVALID_DATA;
  728. if (S_ISDIR(inode->i_mode))
  729. memset(nfsi->cookieverf, 0, sizeof(nfsi->cookieverf));
  730. spin_unlock(&inode->i_lock);
  731. nfs_inc_stats(inode, NFSIOS_DATAINVALIDATE);
  732. nfs_fscache_reset_inode_cookie(inode);
  733. dfprintk(PAGECACHE, "NFS: (%s/%Ld) data cache invalidated\n",
  734. inode->i_sb->s_id, (long long)NFS_FILEID(inode));
  735. return 0;
  736. }
  737. static int nfs_invalidate_mapping(struct inode *inode, struct address_space *mapping)
  738. {
  739. int ret = 0;
  740. mutex_lock(&inode->i_mutex);
  741. if (NFS_I(inode)->cache_validity & NFS_INO_INVALID_DATA) {
  742. ret = nfs_sync_mapping(mapping);
  743. if (ret == 0)
  744. ret = nfs_invalidate_mapping_nolock(inode, mapping);
  745. }
  746. mutex_unlock(&inode->i_mutex);
  747. return ret;
  748. }
  749. /**
  750. * nfs_revalidate_mapping_nolock - Revalidate the pagecache
  751. * @inode - pointer to host inode
  752. * @mapping - pointer to mapping
  753. */
  754. int nfs_revalidate_mapping_nolock(struct inode *inode, struct address_space *mapping)
  755. {
  756. struct nfs_inode *nfsi = NFS_I(inode);
  757. int ret = 0;
  758. if ((nfsi->cache_validity & NFS_INO_REVAL_PAGECACHE)
  759. || nfs_attribute_timeout(inode) || NFS_STALE(inode)) {
  760. ret = __nfs_revalidate_inode(NFS_SERVER(inode), inode);
  761. if (ret < 0)
  762. goto out;
  763. }
  764. if (nfsi->cache_validity & NFS_INO_INVALID_DATA)
  765. ret = nfs_invalidate_mapping_nolock(inode, mapping);
  766. out:
  767. return ret;
  768. }
  769. /**
  770. * nfs_revalidate_mapping - Revalidate the pagecache
  771. * @inode - pointer to host inode
  772. * @mapping - pointer to mapping
  773. *
  774. * This version of the function will take the inode->i_mutex and attempt to
  775. * flush out all dirty data if it needs to invalidate the page cache.
  776. */
  777. int nfs_revalidate_mapping(struct inode *inode, struct address_space *mapping)
  778. {
  779. struct nfs_inode *nfsi = NFS_I(inode);
  780. int ret = 0;
  781. if ((nfsi->cache_validity & NFS_INO_REVAL_PAGECACHE)
  782. || nfs_attribute_timeout(inode) || NFS_STALE(inode)) {
  783. ret = __nfs_revalidate_inode(NFS_SERVER(inode), inode);
  784. if (ret < 0)
  785. goto out;
  786. }
  787. if (nfsi->cache_validity & NFS_INO_INVALID_DATA)
  788. ret = nfs_invalidate_mapping(inode, mapping);
  789. out:
  790. return ret;
  791. }
  792. static void nfs_wcc_update_inode(struct inode *inode, struct nfs_fattr *fattr)
  793. {
  794. struct nfs_inode *nfsi = NFS_I(inode);
  795. if ((fattr->valid & NFS_ATTR_FATTR_PRECHANGE)
  796. && (fattr->valid & NFS_ATTR_FATTR_CHANGE)
  797. && nfsi->change_attr == fattr->pre_change_attr) {
  798. nfsi->change_attr = fattr->change_attr;
  799. if (S_ISDIR(inode->i_mode))
  800. nfsi->cache_validity |= NFS_INO_INVALID_DATA;
  801. }
  802. /* If we have atomic WCC data, we may update some attributes */
  803. if ((fattr->valid & NFS_ATTR_FATTR_PRECTIME)
  804. && (fattr->valid & NFS_ATTR_FATTR_CTIME)
  805. && timespec_equal(&inode->i_ctime, &fattr->pre_ctime))
  806. memcpy(&inode->i_ctime, &fattr->ctime, sizeof(inode->i_ctime));
  807. if ((fattr->valid & NFS_ATTR_FATTR_PREMTIME)
  808. && (fattr->valid & NFS_ATTR_FATTR_MTIME)
  809. && timespec_equal(&inode->i_mtime, &fattr->pre_mtime)) {
  810. memcpy(&inode->i_mtime, &fattr->mtime, sizeof(inode->i_mtime));
  811. if (S_ISDIR(inode->i_mode))
  812. nfsi->cache_validity |= NFS_INO_INVALID_DATA;
  813. }
  814. if ((fattr->valid & NFS_ATTR_FATTR_PRESIZE)
  815. && (fattr->valid & NFS_ATTR_FATTR_SIZE)
  816. && i_size_read(inode) == nfs_size_to_loff_t(fattr->pre_size)
  817. && nfsi->npages == 0)
  818. i_size_write(inode, nfs_size_to_loff_t(fattr->size));
  819. }
  820. /**
  821. * nfs_check_inode_attributes - verify consistency of the inode attribute cache
  822. * @inode - pointer to inode
  823. * @fattr - updated attributes
  824. *
  825. * Verifies the attribute cache. If we have just changed the attributes,
  826. * so that fattr carries weak cache consistency data, then it may
  827. * also update the ctime/mtime/change_attribute.
  828. */
  829. static int nfs_check_inode_attributes(struct inode *inode, struct nfs_fattr *fattr)
  830. {
  831. struct nfs_inode *nfsi = NFS_I(inode);
  832. loff_t cur_size, new_isize;
  833. unsigned long invalid = 0;
  834. /* Has the inode gone and changed behind our back? */
  835. if ((fattr->valid & NFS_ATTR_FATTR_FILEID) && nfsi->fileid != fattr->fileid)
  836. return -EIO;
  837. if ((fattr->valid & NFS_ATTR_FATTR_TYPE) && (inode->i_mode & S_IFMT) != (fattr->mode & S_IFMT))
  838. return -EIO;
  839. if ((fattr->valid & NFS_ATTR_FATTR_CHANGE) != 0 &&
  840. nfsi->change_attr != fattr->change_attr)
  841. invalid |= NFS_INO_INVALID_ATTR|NFS_INO_REVAL_PAGECACHE;
  842. /* Verify a few of the more important attributes */
  843. if ((fattr->valid & NFS_ATTR_FATTR_MTIME) && !timespec_equal(&inode->i_mtime, &fattr->mtime))
  844. invalid |= NFS_INO_INVALID_ATTR|NFS_INO_REVAL_PAGECACHE;
  845. if (fattr->valid & NFS_ATTR_FATTR_SIZE) {
  846. cur_size = i_size_read(inode);
  847. new_isize = nfs_size_to_loff_t(fattr->size);
  848. if (cur_size != new_isize && nfsi->npages == 0)
  849. invalid |= NFS_INO_INVALID_ATTR|NFS_INO_REVAL_PAGECACHE;
  850. }
  851. /* Have any file permissions changed? */
  852. if ((fattr->valid & NFS_ATTR_FATTR_MODE) && (inode->i_mode & S_IALLUGO) != (fattr->mode & S_IALLUGO))
  853. invalid |= NFS_INO_INVALID_ATTR | NFS_INO_INVALID_ACCESS | NFS_INO_INVALID_ACL;
  854. if ((fattr->valid & NFS_ATTR_FATTR_OWNER) && inode->i_uid != fattr->uid)
  855. invalid |= NFS_INO_INVALID_ATTR | NFS_INO_INVALID_ACCESS | NFS_INO_INVALID_ACL;
  856. if ((fattr->valid & NFS_ATTR_FATTR_GROUP) && inode->i_gid != fattr->gid)
  857. invalid |= NFS_INO_INVALID_ATTR | NFS_INO_INVALID_ACCESS | NFS_INO_INVALID_ACL;
  858. /* Has the link count changed? */
  859. if ((fattr->valid & NFS_ATTR_FATTR_NLINK) && inode->i_nlink != fattr->nlink)
  860. invalid |= NFS_INO_INVALID_ATTR;
  861. if ((fattr->valid & NFS_ATTR_FATTR_ATIME) && !timespec_equal(&inode->i_atime, &fattr->atime))
  862. invalid |= NFS_INO_INVALID_ATIME;
  863. if (invalid != 0)
  864. nfsi->cache_validity |= invalid;
  865. nfsi->read_cache_jiffies = fattr->time_start;
  866. return 0;
  867. }
  868. static int nfs_ctime_need_update(const struct inode *inode, const struct nfs_fattr *fattr)
  869. {
  870. if (!(fattr->valid & NFS_ATTR_FATTR_CTIME))
  871. return 0;
  872. return timespec_compare(&fattr->ctime, &inode->i_ctime) > 0;
  873. }
  874. static int nfs_size_need_update(const struct inode *inode, const struct nfs_fattr *fattr)
  875. {
  876. if (!(fattr->valid & NFS_ATTR_FATTR_SIZE))
  877. return 0;
  878. return nfs_size_to_loff_t(fattr->size) > i_size_read(inode);
  879. }
  880. static atomic_long_t nfs_attr_generation_counter;
  881. static unsigned long nfs_read_attr_generation_counter(void)
  882. {
  883. return atomic_long_read(&nfs_attr_generation_counter);
  884. }
  885. unsigned long nfs_inc_attr_generation_counter(void)
  886. {
  887. return atomic_long_inc_return(&nfs_attr_generation_counter);
  888. }
  889. void nfs_fattr_init(struct nfs_fattr *fattr)
  890. {
  891. fattr->valid = 0;
  892. fattr->time_start = jiffies;
  893. fattr->gencount = nfs_inc_attr_generation_counter();
  894. }
  895. /**
  896. * nfs_inode_attrs_need_update - check if the inode attributes need updating
  897. * @inode - pointer to inode
  898. * @fattr - attributes
  899. *
  900. * Attempt to divine whether or not an RPC call reply carrying stale
  901. * attributes got scheduled after another call carrying updated ones.
  902. *
  903. * To do so, the function first assumes that a more recent ctime means
  904. * that the attributes in fattr are newer, however it also attempt to
  905. * catch the case where ctime either didn't change, or went backwards
  906. * (if someone reset the clock on the server) by looking at whether
  907. * or not this RPC call was started after the inode was last updated.
  908. * Note also the check for wraparound of 'attr_gencount'
  909. *
  910. * The function returns 'true' if it thinks the attributes in 'fattr' are
  911. * more recent than the ones cached in the inode.
  912. *
  913. */
  914. static int nfs_inode_attrs_need_update(const struct inode *inode, const struct nfs_fattr *fattr)
  915. {
  916. const struct nfs_inode *nfsi = NFS_I(inode);
  917. return ((long)fattr->gencount - (long)nfsi->attr_gencount) > 0 ||
  918. nfs_ctime_need_update(inode, fattr) ||
  919. nfs_size_need_update(inode, fattr) ||
  920. ((long)nfsi->attr_gencount - (long)nfs_read_attr_generation_counter() > 0);
  921. }
  922. static int nfs_refresh_inode_locked(struct inode *inode, struct nfs_fattr *fattr)
  923. {
  924. if (nfs_inode_attrs_need_update(inode, fattr))
  925. return nfs_update_inode(inode, fattr);
  926. return nfs_check_inode_attributes(inode, fattr);
  927. }
  928. /**
  929. * nfs_refresh_inode - try to update the inode attribute cache
  930. * @inode - pointer to inode
  931. * @fattr - updated attributes
  932. *
  933. * Check that an RPC call that returned attributes has not overlapped with
  934. * other recent updates of the inode metadata, then decide whether it is
  935. * safe to do a full update of the inode attributes, or whether just to
  936. * call nfs_check_inode_attributes.
  937. */
  938. int nfs_refresh_inode(struct inode *inode, struct nfs_fattr *fattr)
  939. {
  940. int status;
  941. if ((fattr->valid & NFS_ATTR_FATTR) == 0)
  942. return 0;
  943. spin_lock(&inode->i_lock);
  944. status = nfs_refresh_inode_locked(inode, fattr);
  945. spin_unlock(&inode->i_lock);
  946. return status;
  947. }
  948. static int nfs_post_op_update_inode_locked(struct inode *inode, struct nfs_fattr *fattr)
  949. {
  950. struct nfs_inode *nfsi = NFS_I(inode);
  951. nfsi->cache_validity |= NFS_INO_INVALID_ATTR|NFS_INO_REVAL_PAGECACHE;
  952. if (S_ISDIR(inode->i_mode))
  953. nfsi->cache_validity |= NFS_INO_INVALID_DATA;
  954. if ((fattr->valid & NFS_ATTR_FATTR) == 0)
  955. return 0;
  956. return nfs_refresh_inode_locked(inode, fattr);
  957. }
  958. /**
  959. * nfs_post_op_update_inode - try to update the inode attribute cache
  960. * @inode - pointer to inode
  961. * @fattr - updated attributes
  962. *
  963. * After an operation that has changed the inode metadata, mark the
  964. * attribute cache as being invalid, then try to update it.
  965. *
  966. * NB: if the server didn't return any post op attributes, this
  967. * function will force the retrieval of attributes before the next
  968. * NFS request. Thus it should be used only for operations that
  969. * are expected to change one or more attributes, to avoid
  970. * unnecessary NFS requests and trips through nfs_update_inode().
  971. */
  972. int nfs_post_op_update_inode(struct inode *inode, struct nfs_fattr *fattr)
  973. {
  974. int status;
  975. spin_lock(&inode->i_lock);
  976. status = nfs_post_op_update_inode_locked(inode, fattr);
  977. spin_unlock(&inode->i_lock);
  978. return status;
  979. }
  980. /**
  981. * nfs_post_op_update_inode_force_wcc - try to update the inode attribute cache
  982. * @inode - pointer to inode
  983. * @fattr - updated attributes
  984. *
  985. * After an operation that has changed the inode metadata, mark the
  986. * attribute cache as being invalid, then try to update it. Fake up
  987. * weak cache consistency data, if none exist.
  988. *
  989. * This function is mainly designed to be used by the ->write_done() functions.
  990. */
  991. int nfs_post_op_update_inode_force_wcc(struct inode *inode, struct nfs_fattr *fattr)
  992. {
  993. int status;
  994. spin_lock(&inode->i_lock);
  995. /* Don't do a WCC update if these attributes are already stale */
  996. if ((fattr->valid & NFS_ATTR_FATTR) == 0 ||
  997. !nfs_inode_attrs_need_update(inode, fattr)) {
  998. fattr->valid &= ~(NFS_ATTR_FATTR_PRECHANGE
  999. | NFS_ATTR_FATTR_PRESIZE
  1000. | NFS_ATTR_FATTR_PREMTIME
  1001. | NFS_ATTR_FATTR_PRECTIME);
  1002. goto out_noforce;
  1003. }
  1004. if ((fattr->valid & NFS_ATTR_FATTR_CHANGE) != 0 &&
  1005. (fattr->valid & NFS_ATTR_FATTR_PRECHANGE) == 0) {
  1006. fattr->pre_change_attr = NFS_I(inode)->change_attr;
  1007. fattr->valid |= NFS_ATTR_FATTR_PRECHANGE;
  1008. }
  1009. if ((fattr->valid & NFS_ATTR_FATTR_CTIME) != 0 &&
  1010. (fattr->valid & NFS_ATTR_FATTR_PRECTIME) == 0) {
  1011. memcpy(&fattr->pre_ctime, &inode->i_ctime, sizeof(fattr->pre_ctime));
  1012. fattr->valid |= NFS_ATTR_FATTR_PRECTIME;
  1013. }
  1014. if ((fattr->valid & NFS_ATTR_FATTR_MTIME) != 0 &&
  1015. (fattr->valid & NFS_ATTR_FATTR_PREMTIME) == 0) {
  1016. memcpy(&fattr->pre_mtime, &inode->i_mtime, sizeof(fattr->pre_mtime));
  1017. fattr->valid |= NFS_ATTR_FATTR_PREMTIME;
  1018. }
  1019. if ((fattr->valid & NFS_ATTR_FATTR_SIZE) != 0 &&
  1020. (fattr->valid & NFS_ATTR_FATTR_PRESIZE) == 0) {
  1021. fattr->pre_size = i_size_read(inode);
  1022. fattr->valid |= NFS_ATTR_FATTR_PRESIZE;
  1023. }
  1024. out_noforce:
  1025. status = nfs_post_op_update_inode_locked(inode, fattr);
  1026. spin_unlock(&inode->i_lock);
  1027. return status;
  1028. }
  1029. /*
  1030. * Many nfs protocol calls return the new file attributes after
  1031. * an operation. Here we update the inode to reflect the state
  1032. * of the server's inode.
  1033. *
  1034. * This is a bit tricky because we have to make sure all dirty pages
  1035. * have been sent off to the server before calling invalidate_inode_pages.
  1036. * To make sure no other process adds more write requests while we try
  1037. * our best to flush them, we make them sleep during the attribute refresh.
  1038. *
  1039. * A very similar scenario holds for the dir cache.
  1040. */
  1041. static int nfs_update_inode(struct inode *inode, struct nfs_fattr *fattr)
  1042. {
  1043. struct nfs_server *server;
  1044. struct nfs_inode *nfsi = NFS_I(inode);
  1045. loff_t cur_isize, new_isize;
  1046. unsigned long invalid = 0;
  1047. unsigned long now = jiffies;
  1048. unsigned long save_cache_validity;
  1049. dfprintk(VFS, "NFS: %s(%s/%ld ct=%d info=0x%x)\n",
  1050. __func__, inode->i_sb->s_id, inode->i_ino,
  1051. atomic_read(&inode->i_count), fattr->valid);
  1052. if ((fattr->valid & NFS_ATTR_FATTR_FILEID) && nfsi->fileid != fattr->fileid)
  1053. goto out_fileid;
  1054. /*
  1055. * Make sure the inode's type hasn't changed.
  1056. */
  1057. if ((fattr->valid & NFS_ATTR_FATTR_TYPE) && (inode->i_mode & S_IFMT) != (fattr->mode & S_IFMT))
  1058. goto out_changed;
  1059. server = NFS_SERVER(inode);
  1060. /* Update the fsid? */
  1061. if (S_ISDIR(inode->i_mode) && (fattr->valid & NFS_ATTR_FATTR_FSID) &&
  1062. !nfs_fsid_equal(&server->fsid, &fattr->fsid) &&
  1063. !test_bit(NFS_INO_MOUNTPOINT, &nfsi->flags))
  1064. server->fsid = fattr->fsid;
  1065. /*
  1066. * Update the read time so we don't revalidate too often.
  1067. */
  1068. nfsi->read_cache_jiffies = fattr->time_start;
  1069. save_cache_validity = nfsi->cache_validity;
  1070. nfsi->cache_validity &= ~(NFS_INO_INVALID_ATTR
  1071. | NFS_INO_INVALID_ATIME
  1072. | NFS_INO_REVAL_FORCED
  1073. | NFS_INO_REVAL_PAGECACHE);
  1074. /* Do atomic weak cache consistency updates */
  1075. nfs_wcc_update_inode(inode, fattr);
  1076. /* More cache consistency checks */
  1077. if (fattr->valid & NFS_ATTR_FATTR_CHANGE) {
  1078. if (nfsi->change_attr != fattr->change_attr) {
  1079. dprintk("NFS: change_attr change on server for file %s/%ld\n",
  1080. inode->i_sb->s_id, inode->i_ino);
  1081. invalid |= NFS_INO_INVALID_ATTR|NFS_INO_INVALID_DATA|NFS_INO_INVALID_ACCESS|NFS_INO_INVALID_ACL;
  1082. if (S_ISDIR(inode->i_mode))
  1083. nfs_force_lookup_revalidate(inode);
  1084. nfsi->change_attr = fattr->change_attr;
  1085. }
  1086. } else if (server->caps & NFS_CAP_CHANGE_ATTR)
  1087. invalid |= save_cache_validity;
  1088. if (fattr->valid & NFS_ATTR_FATTR_MTIME) {
  1089. /* NFSv2/v3: Check if the mtime agrees */
  1090. if (!timespec_equal(&inode->i_mtime, &fattr->mtime)) {
  1091. dprintk("NFS: mtime change on server for file %s/%ld\n",
  1092. inode->i_sb->s_id, inode->i_ino);
  1093. invalid |= NFS_INO_INVALID_ATTR|NFS_INO_INVALID_DATA;
  1094. if (S_ISDIR(inode->i_mode))
  1095. nfs_force_lookup_revalidate(inode);
  1096. memcpy(&inode->i_mtime, &fattr->mtime, sizeof(inode->i_mtime));
  1097. }
  1098. } else if (server->caps & NFS_CAP_MTIME)
  1099. invalid |= save_cache_validity & (NFS_INO_INVALID_ATTR
  1100. | NFS_INO_INVALID_DATA
  1101. | NFS_INO_REVAL_PAGECACHE
  1102. | NFS_INO_REVAL_FORCED);
  1103. if (fattr->valid & NFS_ATTR_FATTR_CTIME) {
  1104. /* If ctime has changed we should definitely clear access+acl caches */
  1105. if (!timespec_equal(&inode->i_ctime, &fattr->ctime)) {
  1106. invalid |= NFS_INO_INVALID_ATTR|NFS_INO_INVALID_ACCESS|NFS_INO_INVALID_ACL;
  1107. /* and probably clear data for a directory too as utimes can cause
  1108. * havoc with our cache.
  1109. */
  1110. if (S_ISDIR(inode->i_mode)) {
  1111. invalid |= NFS_INO_INVALID_DATA;
  1112. nfs_force_lookup_revalidate(inode);
  1113. }
  1114. memcpy(&inode->i_ctime, &fattr->ctime, sizeof(inode->i_ctime));
  1115. }
  1116. } else if (server->caps & NFS_CAP_CTIME)
  1117. invalid |= save_cache_validity & (NFS_INO_INVALID_ATTR
  1118. | NFS_INO_INVALID_ACCESS
  1119. | NFS_INO_INVALID_ACL
  1120. | NFS_INO_REVAL_FORCED);
  1121. /* Check if our cached file size is stale */
  1122. if (fattr->valid & NFS_ATTR_FATTR_SIZE) {
  1123. new_isize = nfs_size_to_loff_t(fattr->size);
  1124. cur_isize = i_size_read(inode);
  1125. if (new_isize != cur_isize) {
  1126. /* Do we perhaps have any outstanding writes, or has
  1127. * the file grown beyond our last write? */
  1128. if (nfsi->npages == 0 || new_isize > cur_isize) {
  1129. i_size_write(inode, new_isize);
  1130. invalid |= NFS_INO_INVALID_ATTR|NFS_INO_INVALID_DATA;
  1131. }
  1132. dprintk("NFS: isize change on server for file %s/%ld\n",
  1133. inode->i_sb->s_id, inode->i_ino);
  1134. }
  1135. } else
  1136. invalid |= save_cache_validity & (NFS_INO_INVALID_ATTR
  1137. | NFS_INO_REVAL_PAGECACHE
  1138. | NFS_INO_REVAL_FORCED);
  1139. if (fattr->valid & NFS_ATTR_FATTR_ATIME)
  1140. memcpy(&inode->i_atime, &fattr->atime, sizeof(inode->i_atime));
  1141. else if (server->caps & NFS_CAP_ATIME)
  1142. invalid |= save_cache_validity & (NFS_INO_INVALID_ATIME
  1143. | NFS_INO_REVAL_FORCED);
  1144. if (fattr->valid & NFS_ATTR_FATTR_MODE) {
  1145. if ((inode->i_mode & S_IALLUGO) != (fattr->mode & S_IALLUGO)) {
  1146. invalid |= NFS_INO_INVALID_ATTR|NFS_INO_INVALID_ACCESS|NFS_INO_INVALID_ACL;
  1147. inode->i_mode = fattr->mode;
  1148. }
  1149. } else if (server->caps & NFS_CAP_MODE)
  1150. invalid |= save_cache_validity & (NFS_INO_INVALID_ATTR
  1151. | NFS_INO_INVALID_ACCESS
  1152. | NFS_INO_INVALID_ACL
  1153. | NFS_INO_REVAL_FORCED);
  1154. if (fattr->valid & NFS_ATTR_FATTR_OWNER) {
  1155. if (inode->i_uid != fattr->uid) {
  1156. invalid |= NFS_INO_INVALID_ATTR|NFS_INO_INVALID_ACCESS|NFS_INO_INVALID_ACL;
  1157. inode->i_uid = fattr->uid;
  1158. }
  1159. } else if (server->caps & NFS_CAP_OWNER)
  1160. invalid |= save_cache_validity & (NFS_INO_INVALID_ATTR
  1161. | NFS_INO_INVALID_ACCESS
  1162. | NFS_INO_INVALID_ACL
  1163. | NFS_INO_REVAL_FORCED);
  1164. if (fattr->valid & NFS_ATTR_FATTR_GROUP) {
  1165. if (inode->i_gid != fattr->gid) {
  1166. invalid |= NFS_INO_INVALID_ATTR|NFS_INO_INVALID_ACCESS|NFS_INO_INVALID_ACL;
  1167. inode->i_gid = fattr->gid;
  1168. }
  1169. } else if (server->caps & NFS_CAP_OWNER_GROUP)
  1170. invalid |= save_cache_validity & (NFS_INO_INVALID_ATTR
  1171. | NFS_INO_INVALID_ACCESS
  1172. | NFS_INO_INVALID_ACL
  1173. | NFS_INO_REVAL_FORCED);
  1174. if (fattr->valid & NFS_ATTR_FATTR_NLINK) {
  1175. if (inode->i_nlink != fattr->nlink) {
  1176. invalid |= NFS_INO_INVALID_ATTR;
  1177. if (S_ISDIR(inode->i_mode))
  1178. invalid |= NFS_INO_INVALID_DATA;
  1179. inode->i_nlink = fattr->nlink;
  1180. }
  1181. } else if (server->caps & NFS_CAP_NLINK)
  1182. invalid |= save_cache_validity & (NFS_INO_INVALID_ATTR
  1183. | NFS_INO_REVAL_FORCED);
  1184. if (fattr->valid & NFS_ATTR_FATTR_SPACE_USED) {
  1185. /*
  1186. * report the blocks in 512byte units
  1187. */
  1188. inode->i_blocks = nfs_calc_block_size(fattr->du.nfs3.used);
  1189. }
  1190. if (fattr->valid & NFS_ATTR_FATTR_BLOCKS_USED)
  1191. inode->i_blocks = fattr->du.nfs2.blocks;
  1192. /* Update attrtimeo value if we're out of the unstable period */
  1193. if (invalid & NFS_INO_INVALID_ATTR) {
  1194. nfs_inc_stats(inode, NFSIOS_ATTRINVALIDATE);
  1195. nfsi->attrtimeo = NFS_MINATTRTIMEO(inode);
  1196. nfsi->attrtimeo_timestamp = now;
  1197. nfsi->attr_gencount = nfs_inc_attr_generation_counter();
  1198. } else {
  1199. if (!time_in_range_open(now, nfsi->attrtimeo_timestamp, nfsi->attrtimeo_timestamp + nfsi->attrtimeo)) {
  1200. if ((nfsi->attrtimeo <<= 1) > NFS_MAXATTRTIMEO(inode))
  1201. nfsi->attrtimeo = NFS_MAXATTRTIMEO(inode);
  1202. nfsi->attrtimeo_timestamp = now;
  1203. }
  1204. }
  1205. invalid &= ~NFS_INO_INVALID_ATTR;
  1206. /* Don't invalidate the data if we were to blame */
  1207. if (!(S_ISREG(inode->i_mode) || S_ISDIR(inode->i_mode)
  1208. || S_ISLNK(inode->i_mode)))
  1209. invalid &= ~NFS_INO_INVALID_DATA;
  1210. if (!nfs_have_delegation(inode, FMODE_READ) ||
  1211. (save_cache_validity & NFS_INO_REVAL_FORCED))
  1212. nfsi->cache_validity |= invalid;
  1213. return 0;
  1214. out_changed:
  1215. /*
  1216. * Big trouble! The inode has become a different object.
  1217. */
  1218. printk(KERN_DEBUG "%s: inode %ld mode changed, %07o to %07o\n",
  1219. __func__, inode->i_ino, inode->i_mode, fattr->mode);
  1220. out_err:
  1221. /*
  1222. * No need to worry about unhashing the dentry, as the
  1223. * lookup validation will know that the inode is bad.
  1224. * (But we fall through to invalidate the caches.)
  1225. */
  1226. nfs_invalidate_inode(inode);
  1227. return -ESTALE;
  1228. out_fileid:
  1229. printk(KERN_ERR "NFS: server %s error: fileid changed\n"
  1230. "fsid %s: expected fileid 0x%Lx, got 0x%Lx\n",
  1231. NFS_SERVER(inode)->nfs_client->cl_hostname, inode->i_sb->s_id,
  1232. (long long)nfsi->fileid, (long long)fattr->fileid);
  1233. goto out_err;
  1234. }
  1235. #ifdef CONFIG_NFS_V4
  1236. /*
  1237. * Clean out any remaining NFSv4 state that might be left over due
  1238. * to open() calls that passed nfs_atomic_lookup, but failed to call
  1239. * nfs_open().
  1240. */
  1241. void nfs4_clear_inode(struct inode *inode)
  1242. {
  1243. /* If we are holding a delegation, return it! */
  1244. nfs_inode_return_delegation_noreclaim(inode);
  1245. /* First call standard NFS clear_inode() code */
  1246. nfs_clear_inode(inode);
  1247. }
  1248. #endif
  1249. struct inode *nfs_alloc_inode(struct super_block *sb)
  1250. {
  1251. struct nfs_inode *nfsi;
  1252. nfsi = (struct nfs_inode *)kmem_cache_alloc(nfs_inode_cachep, GFP_KERNEL);
  1253. if (!nfsi)
  1254. return NULL;
  1255. nfsi->flags = 0UL;
  1256. nfsi->cache_validity = 0UL;
  1257. #ifdef CONFIG_NFS_V3_ACL
  1258. nfsi->acl_access = ERR_PTR(-EAGAIN);
  1259. nfsi->acl_default = ERR_PTR(-EAGAIN);
  1260. #endif
  1261. #ifdef CONFIG_NFS_V4
  1262. nfsi->nfs4_acl = NULL;
  1263. #endif /* CONFIG_NFS_V4 */
  1264. return &nfsi->vfs_inode;
  1265. }
  1266. void nfs_destroy_inode(struct inode *inode)
  1267. {
  1268. kmem_cache_free(nfs_inode_cachep, NFS_I(inode));
  1269. }
  1270. static inline void nfs4_init_once(struct nfs_inode *nfsi)
  1271. {
  1272. #ifdef CONFIG_NFS_V4
  1273. INIT_LIST_HEAD(&nfsi->open_states);
  1274. nfsi->delegation = NULL;
  1275. nfsi->delegation_state = 0;
  1276. init_rwsem(&nfsi->rwsem);
  1277. #endif
  1278. }
  1279. static void init_once(void *foo)
  1280. {
  1281. struct nfs_inode *nfsi = (struct nfs_inode *) foo;
  1282. inode_init_once(&nfsi->vfs_inode);
  1283. INIT_LIST_HEAD(&nfsi->open_files);
  1284. INIT_LIST_HEAD(&nfsi->access_cache_entry_lru);
  1285. INIT_LIST_HEAD(&nfsi->access_cache_inode_lru);
  1286. INIT_RADIX_TREE(&nfsi->nfs_page_tree, GFP_ATOMIC);
  1287. nfsi->npages = 0;
  1288. atomic_set(&nfsi->silly_count, 1);
  1289. INIT_HLIST_HEAD(&nfsi->silly_list);
  1290. init_waitqueue_head(&nfsi->waitqueue);
  1291. nfs4_init_once(nfsi);
  1292. }
  1293. static int __init nfs_init_inodecache(void)
  1294. {
  1295. nfs_inode_cachep = kmem_cache_create("nfs_inode_cache",
  1296. sizeof(struct nfs_inode),
  1297. 0, (SLAB_RECLAIM_ACCOUNT|
  1298. SLAB_MEM_SPREAD),
  1299. init_once);
  1300. if (nfs_inode_cachep == NULL)
  1301. return -ENOMEM;
  1302. return 0;
  1303. }
  1304. static void nfs_destroy_inodecache(void)
  1305. {
  1306. kmem_cache_destroy(nfs_inode_cachep);
  1307. }
  1308. struct workqueue_struct *nfsiod_workqueue;
  1309. /*
  1310. * start up the nfsiod workqueue
  1311. */
  1312. static int nfsiod_start(void)
  1313. {
  1314. struct workqueue_struct *wq;
  1315. dprintk("RPC: creating workqueue nfsiod\n");
  1316. wq = create_singlethread_workqueue("nfsiod");
  1317. if (wq == NULL)
  1318. return -ENOMEM;
  1319. nfsiod_workqueue = wq;
  1320. return 0;
  1321. }
  1322. /*
  1323. * Destroy the nfsiod workqueue
  1324. */
  1325. static void nfsiod_stop(void)
  1326. {
  1327. struct workqueue_struct *wq;
  1328. wq = nfsiod_workqueue;
  1329. if (wq == NULL)
  1330. return;
  1331. nfsiod_workqueue = NULL;
  1332. destroy_workqueue(wq);
  1333. }
  1334. /*
  1335. * Initialize NFS
  1336. */
  1337. static int __init init_nfs_fs(void)
  1338. {
  1339. int err;
  1340. err = nfs_dns_resolver_init();
  1341. if (err < 0)
  1342. goto out8;
  1343. err = nfs_fscache_register();
  1344. if (err < 0)
  1345. goto out7;
  1346. err = nfsiod_start();
  1347. if (err)
  1348. goto out6;
  1349. err = nfs_fs_proc_init();
  1350. if (err)
  1351. goto out5;
  1352. err = nfs_init_nfspagecache();
  1353. if (err)
  1354. goto out4;
  1355. err = nfs_init_inodecache();
  1356. if (err)
  1357. goto out3;
  1358. err = nfs_init_readpagecache();
  1359. if (err)
  1360. goto out2;
  1361. err = nfs_init_writepagecache();
  1362. if (err)
  1363. goto out1;
  1364. err = nfs_init_directcache();
  1365. if (err)
  1366. goto out0;
  1367. #ifdef CONFIG_PROC_FS
  1368. rpc_proc_register(&nfs_rpcstat);
  1369. #endif
  1370. if ((err = register_nfs_fs()) != 0)
  1371. goto out;
  1372. return 0;
  1373. out:
  1374. #ifdef CONFIG_PROC_FS
  1375. rpc_proc_unregister("nfs");
  1376. #endif
  1377. nfs_destroy_directcache();
  1378. out0:
  1379. nfs_destroy_writepagecache();
  1380. out1:
  1381. nfs_destroy_readpagecache();
  1382. out2:
  1383. nfs_destroy_inodecache();
  1384. out3:
  1385. nfs_destroy_nfspagecache();
  1386. out4:
  1387. nfs_fs_proc_exit();
  1388. out5:
  1389. nfsiod_stop();
  1390. out6:
  1391. nfs_fscache_unregister();
  1392. out7:
  1393. nfs_dns_resolver_destroy();
  1394. out8:
  1395. return err;
  1396. }
  1397. static void __exit exit_nfs_fs(void)
  1398. {
  1399. nfs_destroy_directcache();
  1400. nfs_destroy_writepagecache();
  1401. nfs_destroy_readpagecache();
  1402. nfs_destroy_inodecache();
  1403. nfs_destroy_nfspagecache();
  1404. nfs_fscache_unregister();
  1405. nfs_dns_resolver_destroy();
  1406. #ifdef CONFIG_PROC_FS
  1407. rpc_proc_unregister("nfs");
  1408. #endif
  1409. unregister_nfs_fs();
  1410. nfs_fs_proc_exit();
  1411. nfsiod_stop();
  1412. }
  1413. /* Not quite true; I just maintain it */
  1414. MODULE_AUTHOR("Olaf Kirch <okir@monad.swb.de>");
  1415. MODULE_LICENSE("GPL");
  1416. module_param(enable_ino64, bool, 0644);
  1417. module_init(init_nfs_fs)
  1418. module_exit(exit_nfs_fs)