dcache.c 79 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156
  1. /*
  2. * fs/dcache.c
  3. *
  4. * Complete reimplementation
  5. * (C) 1997 Thomas Schoebel-Theuer,
  6. * with heavy changes by Linus Torvalds
  7. */
  8. /*
  9. * Notes on the allocation strategy:
  10. *
  11. * The dcache is a master of the icache - whenever a dcache entry
  12. * exists, the inode will always exist. "iput()" is done either when
  13. * the dcache entry is deleted or garbage collected.
  14. */
  15. #include <linux/syscalls.h>
  16. #include <linux/string.h>
  17. #include <linux/mm.h>
  18. #include <linux/fs.h>
  19. #include <linux/fsnotify.h>
  20. #include <linux/slab.h>
  21. #include <linux/init.h>
  22. #include <linux/hash.h>
  23. #include <linux/cache.h>
  24. #include <linux/export.h>
  25. #include <linux/mount.h>
  26. #include <linux/file.h>
  27. #include <asm/uaccess.h>
  28. #include <linux/security.h>
  29. #include <linux/seqlock.h>
  30. #include <linux/swap.h>
  31. #include <linux/bootmem.h>
  32. #include <linux/fs_struct.h>
  33. #include <linux/hardirq.h>
  34. #include <linux/bit_spinlock.h>
  35. #include <linux/rculist_bl.h>
  36. #include <linux/prefetch.h>
  37. #include <linux/ratelimit.h>
  38. #include "internal.h"
  39. #include "mount.h"
  40. /*
  41. * Usage:
  42. * dcache->d_inode->i_lock protects:
  43. * - i_dentry, d_alias, d_inode of aliases
  44. * dcache_hash_bucket lock protects:
  45. * - the dcache hash table
  46. * s_anon bl list spinlock protects:
  47. * - the s_anon list (see __d_drop)
  48. * dcache_lru_lock protects:
  49. * - the dcache lru lists and counters
  50. * d_lock protects:
  51. * - d_flags
  52. * - d_name
  53. * - d_lru
  54. * - d_count
  55. * - d_unhashed()
  56. * - d_parent and d_subdirs
  57. * - childrens' d_child and d_parent
  58. * - d_alias, d_inode
  59. *
  60. * Ordering:
  61. * dentry->d_inode->i_lock
  62. * dentry->d_lock
  63. * dcache_lru_lock
  64. * dcache_hash_bucket lock
  65. * s_anon lock
  66. *
  67. * If there is an ancestor relationship:
  68. * dentry->d_parent->...->d_parent->d_lock
  69. * ...
  70. * dentry->d_parent->d_lock
  71. * dentry->d_lock
  72. *
  73. * If no ancestor relationship:
  74. * if (dentry1 < dentry2)
  75. * dentry1->d_lock
  76. * dentry2->d_lock
  77. */
  78. int sysctl_vfs_cache_pressure __read_mostly = 100;
  79. EXPORT_SYMBOL_GPL(sysctl_vfs_cache_pressure);
  80. static __cacheline_aligned_in_smp DEFINE_SPINLOCK(dcache_lru_lock);
  81. __cacheline_aligned_in_smp DEFINE_SEQLOCK(rename_lock);
  82. EXPORT_SYMBOL(rename_lock);
  83. static struct kmem_cache *dentry_cache __read_mostly;
  84. /*
  85. * This is the single most critical data structure when it comes
  86. * to the dcache: the hashtable for lookups. Somebody should try
  87. * to make this good - I've just made it work.
  88. *
  89. * This hash-function tries to avoid losing too many bits of hash
  90. * information, yet avoid using a prime hash-size or similar.
  91. */
  92. #define D_HASHBITS d_hash_shift
  93. #define D_HASHMASK d_hash_mask
  94. static unsigned int d_hash_mask __read_mostly;
  95. static unsigned int d_hash_shift __read_mostly;
  96. static struct hlist_bl_head *dentry_hashtable __read_mostly;
  97. static inline struct hlist_bl_head *d_hash(const struct dentry *parent,
  98. unsigned int hash)
  99. {
  100. hash += (unsigned long) parent / L1_CACHE_BYTES;
  101. hash = hash + (hash >> D_HASHBITS);
  102. return dentry_hashtable + (hash & D_HASHMASK);
  103. }
  104. /* Statistics gathering. */
  105. struct dentry_stat_t dentry_stat = {
  106. .age_limit = 45,
  107. };
  108. static DEFINE_PER_CPU(unsigned int, nr_dentry);
  109. #if defined(CONFIG_SYSCTL) && defined(CONFIG_PROC_FS)
  110. static int get_nr_dentry(void)
  111. {
  112. int i;
  113. int sum = 0;
  114. for_each_possible_cpu(i)
  115. sum += per_cpu(nr_dentry, i);
  116. return sum < 0 ? 0 : sum;
  117. }
  118. int proc_nr_dentry(ctl_table *table, int write, void __user *buffer,
  119. size_t *lenp, loff_t *ppos)
  120. {
  121. dentry_stat.nr_dentry = get_nr_dentry();
  122. return proc_dointvec(table, write, buffer, lenp, ppos);
  123. }
  124. #endif
  125. /*
  126. * Compare 2 name strings, return 0 if they match, otherwise non-zero.
  127. * The strings are both count bytes long, and count is non-zero.
  128. */
  129. #ifdef CONFIG_DCACHE_WORD_ACCESS
  130. #include <asm/word-at-a-time.h>
  131. /*
  132. * NOTE! 'cs' and 'scount' come from a dentry, so it has a
  133. * aligned allocation for this particular component. We don't
  134. * strictly need the load_unaligned_zeropad() safety, but it
  135. * doesn't hurt either.
  136. *
  137. * In contrast, 'ct' and 'tcount' can be from a pathname, and do
  138. * need the careful unaligned handling.
  139. */
  140. static inline int dentry_string_cmp(const unsigned char *cs, const unsigned char *ct, unsigned tcount)
  141. {
  142. unsigned long a,b,mask;
  143. for (;;) {
  144. a = *(unsigned long *)cs;
  145. b = load_unaligned_zeropad(ct);
  146. if (tcount < sizeof(unsigned long))
  147. break;
  148. if (unlikely(a != b))
  149. return 1;
  150. cs += sizeof(unsigned long);
  151. ct += sizeof(unsigned long);
  152. tcount -= sizeof(unsigned long);
  153. if (!tcount)
  154. return 0;
  155. }
  156. mask = ~(~0ul << tcount*8);
  157. return unlikely(!!((a ^ b) & mask));
  158. }
  159. #else
  160. static inline int dentry_string_cmp(const unsigned char *cs, const unsigned char *ct, unsigned tcount)
  161. {
  162. do {
  163. if (*cs != *ct)
  164. return 1;
  165. cs++;
  166. ct++;
  167. tcount--;
  168. } while (tcount);
  169. return 0;
  170. }
  171. #endif
  172. static inline int dentry_cmp(const struct dentry *dentry, const unsigned char *ct, unsigned tcount)
  173. {
  174. const unsigned char *cs;
  175. /*
  176. * Be careful about RCU walk racing with rename:
  177. * use ACCESS_ONCE to fetch the name pointer.
  178. *
  179. * NOTE! Even if a rename will mean that the length
  180. * was not loaded atomically, we don't care. The
  181. * RCU walk will check the sequence count eventually,
  182. * and catch it. And we won't overrun the buffer,
  183. * because we're reading the name pointer atomically,
  184. * and a dentry name is guaranteed to be properly
  185. * terminated with a NUL byte.
  186. *
  187. * End result: even if 'len' is wrong, we'll exit
  188. * early because the data cannot match (there can
  189. * be no NUL in the ct/tcount data)
  190. */
  191. cs = ACCESS_ONCE(dentry->d_name.name);
  192. smp_read_barrier_depends();
  193. return dentry_string_cmp(cs, ct, tcount);
  194. }
  195. static void __d_free(struct rcu_head *head)
  196. {
  197. struct dentry *dentry = container_of(head, struct dentry, d_u.d_rcu);
  198. WARN_ON(!hlist_unhashed(&dentry->d_alias));
  199. if (dname_external(dentry))
  200. kfree(dentry->d_name.name);
  201. kmem_cache_free(dentry_cache, dentry);
  202. }
  203. /*
  204. * no locks, please.
  205. */
  206. static void d_free(struct dentry *dentry)
  207. {
  208. BUG_ON(dentry->d_lockref.count);
  209. this_cpu_dec(nr_dentry);
  210. if (dentry->d_op && dentry->d_op->d_release)
  211. dentry->d_op->d_release(dentry);
  212. /* if dentry was never visible to RCU, immediate free is OK */
  213. if (!(dentry->d_flags & DCACHE_RCUACCESS))
  214. __d_free(&dentry->d_u.d_rcu);
  215. else
  216. call_rcu(&dentry->d_u.d_rcu, __d_free);
  217. }
  218. /**
  219. * dentry_rcuwalk_barrier - invalidate in-progress rcu-walk lookups
  220. * @dentry: the target dentry
  221. * After this call, in-progress rcu-walk path lookup will fail. This
  222. * should be called after unhashing, and after changing d_inode (if
  223. * the dentry has not already been unhashed).
  224. */
  225. static inline void dentry_rcuwalk_barrier(struct dentry *dentry)
  226. {
  227. assert_spin_locked(&dentry->d_lock);
  228. /* Go through a barrier */
  229. write_seqcount_barrier(&dentry->d_seq);
  230. }
  231. /*
  232. * Release the dentry's inode, using the filesystem
  233. * d_iput() operation if defined. Dentry has no refcount
  234. * and is unhashed.
  235. */
  236. static void dentry_iput(struct dentry * dentry)
  237. __releases(dentry->d_lock)
  238. __releases(dentry->d_inode->i_lock)
  239. {
  240. struct inode *inode = dentry->d_inode;
  241. if (inode) {
  242. dentry->d_inode = NULL;
  243. hlist_del_init(&dentry->d_alias);
  244. spin_unlock(&dentry->d_lock);
  245. spin_unlock(&inode->i_lock);
  246. if (!inode->i_nlink)
  247. fsnotify_inoderemove(inode);
  248. if (dentry->d_op && dentry->d_op->d_iput)
  249. dentry->d_op->d_iput(dentry, inode);
  250. else
  251. iput(inode);
  252. } else {
  253. spin_unlock(&dentry->d_lock);
  254. }
  255. }
  256. /*
  257. * Release the dentry's inode, using the filesystem
  258. * d_iput() operation if defined. dentry remains in-use.
  259. */
  260. static void dentry_unlink_inode(struct dentry * dentry)
  261. __releases(dentry->d_lock)
  262. __releases(dentry->d_inode->i_lock)
  263. {
  264. struct inode *inode = dentry->d_inode;
  265. dentry->d_inode = NULL;
  266. hlist_del_init(&dentry->d_alias);
  267. dentry_rcuwalk_barrier(dentry);
  268. spin_unlock(&dentry->d_lock);
  269. spin_unlock(&inode->i_lock);
  270. if (!inode->i_nlink)
  271. fsnotify_inoderemove(inode);
  272. if (dentry->d_op && dentry->d_op->d_iput)
  273. dentry->d_op->d_iput(dentry, inode);
  274. else
  275. iput(inode);
  276. }
  277. /*
  278. * dentry_lru_(add|del|prune|move_tail) must be called with d_lock held.
  279. */
  280. static void dentry_lru_add(struct dentry *dentry)
  281. {
  282. if (list_empty(&dentry->d_lru)) {
  283. spin_lock(&dcache_lru_lock);
  284. list_add(&dentry->d_lru, &dentry->d_sb->s_dentry_lru);
  285. dentry->d_sb->s_nr_dentry_unused++;
  286. dentry_stat.nr_unused++;
  287. spin_unlock(&dcache_lru_lock);
  288. }
  289. }
  290. static void __dentry_lru_del(struct dentry *dentry)
  291. {
  292. list_del_init(&dentry->d_lru);
  293. dentry->d_flags &= ~DCACHE_SHRINK_LIST;
  294. dentry->d_sb->s_nr_dentry_unused--;
  295. dentry_stat.nr_unused--;
  296. }
  297. /*
  298. * Remove a dentry with references from the LRU.
  299. */
  300. static void dentry_lru_del(struct dentry *dentry)
  301. {
  302. if (!list_empty(&dentry->d_lru)) {
  303. spin_lock(&dcache_lru_lock);
  304. __dentry_lru_del(dentry);
  305. spin_unlock(&dcache_lru_lock);
  306. }
  307. }
  308. static void dentry_lru_move_list(struct dentry *dentry, struct list_head *list)
  309. {
  310. spin_lock(&dcache_lru_lock);
  311. if (list_empty(&dentry->d_lru)) {
  312. list_add_tail(&dentry->d_lru, list);
  313. dentry->d_sb->s_nr_dentry_unused++;
  314. dentry_stat.nr_unused++;
  315. } else {
  316. list_move_tail(&dentry->d_lru, list);
  317. }
  318. spin_unlock(&dcache_lru_lock);
  319. }
  320. /**
  321. * d_kill - kill dentry and return parent
  322. * @dentry: dentry to kill
  323. * @parent: parent dentry
  324. *
  325. * The dentry must already be unhashed and removed from the LRU.
  326. *
  327. * If this is the root of the dentry tree, return NULL.
  328. *
  329. * dentry->d_lock and parent->d_lock must be held by caller, and are dropped by
  330. * d_kill.
  331. */
  332. static struct dentry *d_kill(struct dentry *dentry, struct dentry *parent)
  333. __releases(dentry->d_lock)
  334. __releases(parent->d_lock)
  335. __releases(dentry->d_inode->i_lock)
  336. {
  337. list_del(&dentry->d_u.d_child);
  338. /*
  339. * Inform try_to_ascend() that we are no longer attached to the
  340. * dentry tree
  341. */
  342. dentry->d_flags |= DCACHE_DENTRY_KILLED;
  343. if (parent)
  344. spin_unlock(&parent->d_lock);
  345. dentry_iput(dentry);
  346. /*
  347. * dentry_iput drops the locks, at which point nobody (except
  348. * transient RCU lookups) can reach this dentry.
  349. */
  350. d_free(dentry);
  351. return parent;
  352. }
  353. /*
  354. * Unhash a dentry without inserting an RCU walk barrier or checking that
  355. * dentry->d_lock is locked. The caller must take care of that, if
  356. * appropriate.
  357. */
  358. static void __d_shrink(struct dentry *dentry)
  359. {
  360. if (!d_unhashed(dentry)) {
  361. struct hlist_bl_head *b;
  362. if (unlikely(dentry->d_flags & DCACHE_DISCONNECTED))
  363. b = &dentry->d_sb->s_anon;
  364. else
  365. b = d_hash(dentry->d_parent, dentry->d_name.hash);
  366. hlist_bl_lock(b);
  367. __hlist_bl_del(&dentry->d_hash);
  368. dentry->d_hash.pprev = NULL;
  369. hlist_bl_unlock(b);
  370. }
  371. }
  372. /**
  373. * d_drop - drop a dentry
  374. * @dentry: dentry to drop
  375. *
  376. * d_drop() unhashes the entry from the parent dentry hashes, so that it won't
  377. * be found through a VFS lookup any more. Note that this is different from
  378. * deleting the dentry - d_delete will try to mark the dentry negative if
  379. * possible, giving a successful _negative_ lookup, while d_drop will
  380. * just make the cache lookup fail.
  381. *
  382. * d_drop() is used mainly for stuff that wants to invalidate a dentry for some
  383. * reason (NFS timeouts or autofs deletes).
  384. *
  385. * __d_drop requires dentry->d_lock.
  386. */
  387. void __d_drop(struct dentry *dentry)
  388. {
  389. if (!d_unhashed(dentry)) {
  390. __d_shrink(dentry);
  391. dentry_rcuwalk_barrier(dentry);
  392. }
  393. }
  394. EXPORT_SYMBOL(__d_drop);
  395. void d_drop(struct dentry *dentry)
  396. {
  397. spin_lock(&dentry->d_lock);
  398. __d_drop(dentry);
  399. spin_unlock(&dentry->d_lock);
  400. }
  401. EXPORT_SYMBOL(d_drop);
  402. /*
  403. * Finish off a dentry we've decided to kill.
  404. * dentry->d_lock must be held, returns with it unlocked.
  405. * If ref is non-zero, then decrement the refcount too.
  406. * Returns dentry requiring refcount drop, or NULL if we're done.
  407. */
  408. static inline struct dentry *dentry_kill(struct dentry *dentry, int ref)
  409. __releases(dentry->d_lock)
  410. {
  411. struct inode *inode;
  412. struct dentry *parent;
  413. inode = dentry->d_inode;
  414. if (inode && !spin_trylock(&inode->i_lock)) {
  415. relock:
  416. spin_unlock(&dentry->d_lock);
  417. cpu_relax();
  418. return dentry; /* try again with same dentry */
  419. }
  420. if (IS_ROOT(dentry))
  421. parent = NULL;
  422. else
  423. parent = dentry->d_parent;
  424. if (parent && !spin_trylock(&parent->d_lock)) {
  425. if (inode)
  426. spin_unlock(&inode->i_lock);
  427. goto relock;
  428. }
  429. if (ref)
  430. dentry->d_lockref.count--;
  431. /*
  432. * inform the fs via d_prune that this dentry is about to be
  433. * unhashed and destroyed.
  434. */
  435. if ((dentry->d_flags & DCACHE_OP_PRUNE) && !d_unhashed(dentry))
  436. dentry->d_op->d_prune(dentry);
  437. dentry_lru_del(dentry);
  438. /* if it was on the hash then remove it */
  439. __d_drop(dentry);
  440. return d_kill(dentry, parent);
  441. }
  442. /*
  443. * This is dput
  444. *
  445. * This is complicated by the fact that we do not want to put
  446. * dentries that are no longer on any hash chain on the unused
  447. * list: we'd much rather just get rid of them immediately.
  448. *
  449. * However, that implies that we have to traverse the dentry
  450. * tree upwards to the parents which might _also_ now be
  451. * scheduled for deletion (it may have been only waiting for
  452. * its last child to go away).
  453. *
  454. * This tail recursion is done by hand as we don't want to depend
  455. * on the compiler to always get this right (gcc generally doesn't).
  456. * Real recursion would eat up our stack space.
  457. */
  458. /*
  459. * dput - release a dentry
  460. * @dentry: dentry to release
  461. *
  462. * Release a dentry. This will drop the usage count and if appropriate
  463. * call the dentry unlink method as well as removing it from the queues and
  464. * releasing its resources. If the parent dentries were scheduled for release
  465. * they too may now get deleted.
  466. */
  467. void dput(struct dentry *dentry)
  468. {
  469. if (!dentry)
  470. return;
  471. repeat:
  472. if (dentry->d_lockref.count == 1)
  473. might_sleep();
  474. if (lockref_put_or_lock(&dentry->d_lockref))
  475. return;
  476. if (dentry->d_flags & DCACHE_OP_DELETE) {
  477. if (dentry->d_op->d_delete(dentry))
  478. goto kill_it;
  479. }
  480. /* Unreachable? Get rid of it */
  481. if (d_unhashed(dentry))
  482. goto kill_it;
  483. dentry->d_flags |= DCACHE_REFERENCED;
  484. dentry_lru_add(dentry);
  485. dentry->d_lockref.count--;
  486. spin_unlock(&dentry->d_lock);
  487. return;
  488. kill_it:
  489. dentry = dentry_kill(dentry, 1);
  490. if (dentry)
  491. goto repeat;
  492. }
  493. EXPORT_SYMBOL(dput);
  494. /**
  495. * d_invalidate - invalidate a dentry
  496. * @dentry: dentry to invalidate
  497. *
  498. * Try to invalidate the dentry if it turns out to be
  499. * possible. If there are other dentries that can be
  500. * reached through this one we can't delete it and we
  501. * return -EBUSY. On success we return 0.
  502. *
  503. * no dcache lock.
  504. */
  505. int d_invalidate(struct dentry * dentry)
  506. {
  507. /*
  508. * If it's already been dropped, return OK.
  509. */
  510. spin_lock(&dentry->d_lock);
  511. if (d_unhashed(dentry)) {
  512. spin_unlock(&dentry->d_lock);
  513. return 0;
  514. }
  515. /*
  516. * Check whether to do a partial shrink_dcache
  517. * to get rid of unused child entries.
  518. */
  519. if (!list_empty(&dentry->d_subdirs)) {
  520. spin_unlock(&dentry->d_lock);
  521. shrink_dcache_parent(dentry);
  522. spin_lock(&dentry->d_lock);
  523. }
  524. /*
  525. * Somebody else still using it?
  526. *
  527. * If it's a directory, we can't drop it
  528. * for fear of somebody re-populating it
  529. * with children (even though dropping it
  530. * would make it unreachable from the root,
  531. * we might still populate it if it was a
  532. * working directory or similar).
  533. * We also need to leave mountpoints alone,
  534. * directory or not.
  535. */
  536. if (dentry->d_lockref.count > 1 && dentry->d_inode) {
  537. if (S_ISDIR(dentry->d_inode->i_mode) || d_mountpoint(dentry)) {
  538. spin_unlock(&dentry->d_lock);
  539. return -EBUSY;
  540. }
  541. }
  542. __d_drop(dentry);
  543. spin_unlock(&dentry->d_lock);
  544. return 0;
  545. }
  546. EXPORT_SYMBOL(d_invalidate);
  547. /* This must be called with d_lock held */
  548. static inline void __dget_dlock(struct dentry *dentry)
  549. {
  550. dentry->d_lockref.count++;
  551. }
  552. static inline void __dget(struct dentry *dentry)
  553. {
  554. lockref_get(&dentry->d_lockref);
  555. }
  556. struct dentry *dget_parent(struct dentry *dentry)
  557. {
  558. int gotref;
  559. struct dentry *ret;
  560. /*
  561. * Do optimistic parent lookup without any
  562. * locking.
  563. */
  564. rcu_read_lock();
  565. ret = ACCESS_ONCE(dentry->d_parent);
  566. gotref = lockref_get_not_zero(&ret->d_lockref);
  567. rcu_read_unlock();
  568. if (likely(gotref)) {
  569. if (likely(ret == ACCESS_ONCE(dentry->d_parent)))
  570. return ret;
  571. dput(ret);
  572. }
  573. repeat:
  574. /*
  575. * Don't need rcu_dereference because we re-check it was correct under
  576. * the lock.
  577. */
  578. rcu_read_lock();
  579. ret = dentry->d_parent;
  580. spin_lock(&ret->d_lock);
  581. if (unlikely(ret != dentry->d_parent)) {
  582. spin_unlock(&ret->d_lock);
  583. rcu_read_unlock();
  584. goto repeat;
  585. }
  586. rcu_read_unlock();
  587. BUG_ON(!ret->d_lockref.count);
  588. ret->d_lockref.count++;
  589. spin_unlock(&ret->d_lock);
  590. return ret;
  591. }
  592. EXPORT_SYMBOL(dget_parent);
  593. /**
  594. * d_find_alias - grab a hashed alias of inode
  595. * @inode: inode in question
  596. * @want_discon: flag, used by d_splice_alias, to request
  597. * that only a DISCONNECTED alias be returned.
  598. *
  599. * If inode has a hashed alias, or is a directory and has any alias,
  600. * acquire the reference to alias and return it. Otherwise return NULL.
  601. * Notice that if inode is a directory there can be only one alias and
  602. * it can be unhashed only if it has no children, or if it is the root
  603. * of a filesystem.
  604. *
  605. * If the inode has an IS_ROOT, DCACHE_DISCONNECTED alias, then prefer
  606. * any other hashed alias over that one unless @want_discon is set,
  607. * in which case only return an IS_ROOT, DCACHE_DISCONNECTED alias.
  608. */
  609. static struct dentry *__d_find_alias(struct inode *inode, int want_discon)
  610. {
  611. struct dentry *alias, *discon_alias;
  612. again:
  613. discon_alias = NULL;
  614. hlist_for_each_entry(alias, &inode->i_dentry, d_alias) {
  615. spin_lock(&alias->d_lock);
  616. if (S_ISDIR(inode->i_mode) || !d_unhashed(alias)) {
  617. if (IS_ROOT(alias) &&
  618. (alias->d_flags & DCACHE_DISCONNECTED)) {
  619. discon_alias = alias;
  620. } else if (!want_discon) {
  621. __dget_dlock(alias);
  622. spin_unlock(&alias->d_lock);
  623. return alias;
  624. }
  625. }
  626. spin_unlock(&alias->d_lock);
  627. }
  628. if (discon_alias) {
  629. alias = discon_alias;
  630. spin_lock(&alias->d_lock);
  631. if (S_ISDIR(inode->i_mode) || !d_unhashed(alias)) {
  632. if (IS_ROOT(alias) &&
  633. (alias->d_flags & DCACHE_DISCONNECTED)) {
  634. __dget_dlock(alias);
  635. spin_unlock(&alias->d_lock);
  636. return alias;
  637. }
  638. }
  639. spin_unlock(&alias->d_lock);
  640. goto again;
  641. }
  642. return NULL;
  643. }
  644. struct dentry *d_find_alias(struct inode *inode)
  645. {
  646. struct dentry *de = NULL;
  647. if (!hlist_empty(&inode->i_dentry)) {
  648. spin_lock(&inode->i_lock);
  649. de = __d_find_alias(inode, 0);
  650. spin_unlock(&inode->i_lock);
  651. }
  652. return de;
  653. }
  654. EXPORT_SYMBOL(d_find_alias);
  655. /*
  656. * Try to kill dentries associated with this inode.
  657. * WARNING: you must own a reference to inode.
  658. */
  659. void d_prune_aliases(struct inode *inode)
  660. {
  661. struct dentry *dentry;
  662. restart:
  663. spin_lock(&inode->i_lock);
  664. hlist_for_each_entry(dentry, &inode->i_dentry, d_alias) {
  665. spin_lock(&dentry->d_lock);
  666. if (!dentry->d_lockref.count) {
  667. /*
  668. * inform the fs via d_prune that this dentry
  669. * is about to be unhashed and destroyed.
  670. */
  671. if ((dentry->d_flags & DCACHE_OP_PRUNE) &&
  672. !d_unhashed(dentry))
  673. dentry->d_op->d_prune(dentry);
  674. __dget_dlock(dentry);
  675. __d_drop(dentry);
  676. spin_unlock(&dentry->d_lock);
  677. spin_unlock(&inode->i_lock);
  678. dput(dentry);
  679. goto restart;
  680. }
  681. spin_unlock(&dentry->d_lock);
  682. }
  683. spin_unlock(&inode->i_lock);
  684. }
  685. EXPORT_SYMBOL(d_prune_aliases);
  686. /*
  687. * Try to throw away a dentry - free the inode, dput the parent.
  688. * Requires dentry->d_lock is held, and dentry->d_count == 0.
  689. * Releases dentry->d_lock.
  690. *
  691. * This may fail if locks cannot be acquired no problem, just try again.
  692. */
  693. static void try_prune_one_dentry(struct dentry *dentry)
  694. __releases(dentry->d_lock)
  695. {
  696. struct dentry *parent;
  697. parent = dentry_kill(dentry, 0);
  698. /*
  699. * If dentry_kill returns NULL, we have nothing more to do.
  700. * if it returns the same dentry, trylocks failed. In either
  701. * case, just loop again.
  702. *
  703. * Otherwise, we need to prune ancestors too. This is necessary
  704. * to prevent quadratic behavior of shrink_dcache_parent(), but
  705. * is also expected to be beneficial in reducing dentry cache
  706. * fragmentation.
  707. */
  708. if (!parent)
  709. return;
  710. if (parent == dentry)
  711. return;
  712. /* Prune ancestors. */
  713. dentry = parent;
  714. while (dentry) {
  715. if (lockref_put_or_lock(&dentry->d_lockref))
  716. return;
  717. dentry = dentry_kill(dentry, 1);
  718. }
  719. }
  720. static void shrink_dentry_list(struct list_head *list)
  721. {
  722. struct dentry *dentry;
  723. rcu_read_lock();
  724. for (;;) {
  725. dentry = list_entry_rcu(list->prev, struct dentry, d_lru);
  726. if (&dentry->d_lru == list)
  727. break; /* empty */
  728. spin_lock(&dentry->d_lock);
  729. if (dentry != list_entry(list->prev, struct dentry, d_lru)) {
  730. spin_unlock(&dentry->d_lock);
  731. continue;
  732. }
  733. /*
  734. * We found an inuse dentry which was not removed from
  735. * the LRU because of laziness during lookup. Do not free
  736. * it - just keep it off the LRU list.
  737. */
  738. if (dentry->d_lockref.count) {
  739. dentry_lru_del(dentry);
  740. spin_unlock(&dentry->d_lock);
  741. continue;
  742. }
  743. rcu_read_unlock();
  744. try_prune_one_dentry(dentry);
  745. rcu_read_lock();
  746. }
  747. rcu_read_unlock();
  748. }
  749. /**
  750. * prune_dcache_sb - shrink the dcache
  751. * @sb: superblock
  752. * @count: number of entries to try to free
  753. *
  754. * Attempt to shrink the superblock dcache LRU by @count entries. This is
  755. * done when we need more memory an called from the superblock shrinker
  756. * function.
  757. *
  758. * This function may fail to free any resources if all the dentries are in
  759. * use.
  760. */
  761. void prune_dcache_sb(struct super_block *sb, int count)
  762. {
  763. struct dentry *dentry;
  764. LIST_HEAD(referenced);
  765. LIST_HEAD(tmp);
  766. relock:
  767. spin_lock(&dcache_lru_lock);
  768. while (!list_empty(&sb->s_dentry_lru)) {
  769. dentry = list_entry(sb->s_dentry_lru.prev,
  770. struct dentry, d_lru);
  771. BUG_ON(dentry->d_sb != sb);
  772. if (!spin_trylock(&dentry->d_lock)) {
  773. spin_unlock(&dcache_lru_lock);
  774. cpu_relax();
  775. goto relock;
  776. }
  777. if (dentry->d_flags & DCACHE_REFERENCED) {
  778. dentry->d_flags &= ~DCACHE_REFERENCED;
  779. list_move(&dentry->d_lru, &referenced);
  780. spin_unlock(&dentry->d_lock);
  781. } else {
  782. list_move_tail(&dentry->d_lru, &tmp);
  783. dentry->d_flags |= DCACHE_SHRINK_LIST;
  784. spin_unlock(&dentry->d_lock);
  785. if (!--count)
  786. break;
  787. }
  788. cond_resched_lock(&dcache_lru_lock);
  789. }
  790. if (!list_empty(&referenced))
  791. list_splice(&referenced, &sb->s_dentry_lru);
  792. spin_unlock(&dcache_lru_lock);
  793. shrink_dentry_list(&tmp);
  794. }
  795. /**
  796. * shrink_dcache_sb - shrink dcache for a superblock
  797. * @sb: superblock
  798. *
  799. * Shrink the dcache for the specified super block. This is used to free
  800. * the dcache before unmounting a file system.
  801. */
  802. void shrink_dcache_sb(struct super_block *sb)
  803. {
  804. LIST_HEAD(tmp);
  805. spin_lock(&dcache_lru_lock);
  806. while (!list_empty(&sb->s_dentry_lru)) {
  807. list_splice_init(&sb->s_dentry_lru, &tmp);
  808. spin_unlock(&dcache_lru_lock);
  809. shrink_dentry_list(&tmp);
  810. spin_lock(&dcache_lru_lock);
  811. }
  812. spin_unlock(&dcache_lru_lock);
  813. }
  814. EXPORT_SYMBOL(shrink_dcache_sb);
  815. /*
  816. * destroy a single subtree of dentries for unmount
  817. * - see the comments on shrink_dcache_for_umount() for a description of the
  818. * locking
  819. */
  820. static void shrink_dcache_for_umount_subtree(struct dentry *dentry)
  821. {
  822. struct dentry *parent;
  823. BUG_ON(!IS_ROOT(dentry));
  824. for (;;) {
  825. /* descend to the first leaf in the current subtree */
  826. while (!list_empty(&dentry->d_subdirs))
  827. dentry = list_entry(dentry->d_subdirs.next,
  828. struct dentry, d_u.d_child);
  829. /* consume the dentries from this leaf up through its parents
  830. * until we find one with children or run out altogether */
  831. do {
  832. struct inode *inode;
  833. /*
  834. * inform the fs that this dentry is about to be
  835. * unhashed and destroyed.
  836. */
  837. if ((dentry->d_flags & DCACHE_OP_PRUNE) &&
  838. !d_unhashed(dentry))
  839. dentry->d_op->d_prune(dentry);
  840. dentry_lru_del(dentry);
  841. __d_shrink(dentry);
  842. if (dentry->d_lockref.count != 0) {
  843. printk(KERN_ERR
  844. "BUG: Dentry %p{i=%lx,n=%s}"
  845. " still in use (%d)"
  846. " [unmount of %s %s]\n",
  847. dentry,
  848. dentry->d_inode ?
  849. dentry->d_inode->i_ino : 0UL,
  850. dentry->d_name.name,
  851. dentry->d_lockref.count,
  852. dentry->d_sb->s_type->name,
  853. dentry->d_sb->s_id);
  854. BUG();
  855. }
  856. if (IS_ROOT(dentry)) {
  857. parent = NULL;
  858. list_del(&dentry->d_u.d_child);
  859. } else {
  860. parent = dentry->d_parent;
  861. parent->d_lockref.count--;
  862. list_del(&dentry->d_u.d_child);
  863. }
  864. inode = dentry->d_inode;
  865. if (inode) {
  866. dentry->d_inode = NULL;
  867. hlist_del_init(&dentry->d_alias);
  868. if (dentry->d_op && dentry->d_op->d_iput)
  869. dentry->d_op->d_iput(dentry, inode);
  870. else
  871. iput(inode);
  872. }
  873. d_free(dentry);
  874. /* finished when we fall off the top of the tree,
  875. * otherwise we ascend to the parent and move to the
  876. * next sibling if there is one */
  877. if (!parent)
  878. return;
  879. dentry = parent;
  880. } while (list_empty(&dentry->d_subdirs));
  881. dentry = list_entry(dentry->d_subdirs.next,
  882. struct dentry, d_u.d_child);
  883. }
  884. }
  885. /*
  886. * destroy the dentries attached to a superblock on unmounting
  887. * - we don't need to use dentry->d_lock because:
  888. * - the superblock is detached from all mountings and open files, so the
  889. * dentry trees will not be rearranged by the VFS
  890. * - s_umount is write-locked, so the memory pressure shrinker will ignore
  891. * any dentries belonging to this superblock that it comes across
  892. * - the filesystem itself is no longer permitted to rearrange the dentries
  893. * in this superblock
  894. */
  895. void shrink_dcache_for_umount(struct super_block *sb)
  896. {
  897. struct dentry *dentry;
  898. if (down_read_trylock(&sb->s_umount))
  899. BUG();
  900. dentry = sb->s_root;
  901. sb->s_root = NULL;
  902. dentry->d_lockref.count--;
  903. shrink_dcache_for_umount_subtree(dentry);
  904. while (!hlist_bl_empty(&sb->s_anon)) {
  905. dentry = hlist_bl_entry(hlist_bl_first(&sb->s_anon), struct dentry, d_hash);
  906. shrink_dcache_for_umount_subtree(dentry);
  907. }
  908. }
  909. /*
  910. * This tries to ascend one level of parenthood, but
  911. * we can race with renaming, so we need to re-check
  912. * the parenthood after dropping the lock and check
  913. * that the sequence number still matches.
  914. */
  915. static struct dentry *try_to_ascend(struct dentry *old, int locked, unsigned seq)
  916. {
  917. struct dentry *new = old->d_parent;
  918. rcu_read_lock();
  919. spin_unlock(&old->d_lock);
  920. spin_lock(&new->d_lock);
  921. /*
  922. * might go back up the wrong parent if we have had a rename
  923. * or deletion
  924. */
  925. if (new != old->d_parent ||
  926. (old->d_flags & DCACHE_DENTRY_KILLED) ||
  927. (!locked && read_seqretry(&rename_lock, seq))) {
  928. spin_unlock(&new->d_lock);
  929. new = NULL;
  930. }
  931. rcu_read_unlock();
  932. return new;
  933. }
  934. /**
  935. * enum d_walk_ret - action to talke during tree walk
  936. * @D_WALK_CONTINUE: contrinue walk
  937. * @D_WALK_QUIT: quit walk
  938. * @D_WALK_NORETRY: quit when retry is needed
  939. * @D_WALK_SKIP: skip this dentry and its children
  940. */
  941. enum d_walk_ret {
  942. D_WALK_CONTINUE,
  943. D_WALK_QUIT,
  944. D_WALK_NORETRY,
  945. D_WALK_SKIP,
  946. };
  947. /**
  948. * d_walk - walk the dentry tree
  949. * @parent: start of walk
  950. * @data: data passed to @enter() and @finish()
  951. * @enter: callback when first entering the dentry
  952. * @finish: callback when successfully finished the walk
  953. *
  954. * The @enter() and @finish() callbacks are called with d_lock held.
  955. */
  956. static void d_walk(struct dentry *parent, void *data,
  957. enum d_walk_ret (*enter)(void *, struct dentry *),
  958. void (*finish)(void *))
  959. {
  960. struct dentry *this_parent;
  961. struct list_head *next;
  962. unsigned seq;
  963. int locked = 0;
  964. enum d_walk_ret ret;
  965. bool retry = true;
  966. seq = read_seqbegin(&rename_lock);
  967. again:
  968. this_parent = parent;
  969. spin_lock(&this_parent->d_lock);
  970. ret = enter(data, this_parent);
  971. switch (ret) {
  972. case D_WALK_CONTINUE:
  973. break;
  974. case D_WALK_QUIT:
  975. case D_WALK_SKIP:
  976. goto out_unlock;
  977. case D_WALK_NORETRY:
  978. retry = false;
  979. break;
  980. }
  981. repeat:
  982. next = this_parent->d_subdirs.next;
  983. resume:
  984. while (next != &this_parent->d_subdirs) {
  985. struct list_head *tmp = next;
  986. struct dentry *dentry = list_entry(tmp, struct dentry, d_u.d_child);
  987. next = tmp->next;
  988. spin_lock_nested(&dentry->d_lock, DENTRY_D_LOCK_NESTED);
  989. ret = enter(data, dentry);
  990. switch (ret) {
  991. case D_WALK_CONTINUE:
  992. break;
  993. case D_WALK_QUIT:
  994. spin_unlock(&dentry->d_lock);
  995. goto out_unlock;
  996. case D_WALK_NORETRY:
  997. retry = false;
  998. break;
  999. case D_WALK_SKIP:
  1000. spin_unlock(&dentry->d_lock);
  1001. continue;
  1002. }
  1003. if (!list_empty(&dentry->d_subdirs)) {
  1004. spin_unlock(&this_parent->d_lock);
  1005. spin_release(&dentry->d_lock.dep_map, 1, _RET_IP_);
  1006. this_parent = dentry;
  1007. spin_acquire(&this_parent->d_lock.dep_map, 0, 1, _RET_IP_);
  1008. goto repeat;
  1009. }
  1010. spin_unlock(&dentry->d_lock);
  1011. }
  1012. /*
  1013. * All done at this level ... ascend and resume the search.
  1014. */
  1015. if (this_parent != parent) {
  1016. struct dentry *child = this_parent;
  1017. this_parent = try_to_ascend(this_parent, locked, seq);
  1018. if (!this_parent)
  1019. goto rename_retry;
  1020. next = child->d_u.d_child.next;
  1021. goto resume;
  1022. }
  1023. if (!locked && read_seqretry(&rename_lock, seq)) {
  1024. spin_unlock(&this_parent->d_lock);
  1025. goto rename_retry;
  1026. }
  1027. if (finish)
  1028. finish(data);
  1029. out_unlock:
  1030. spin_unlock(&this_parent->d_lock);
  1031. if (locked)
  1032. write_sequnlock(&rename_lock);
  1033. return;
  1034. rename_retry:
  1035. if (!retry)
  1036. return;
  1037. if (locked)
  1038. goto again;
  1039. locked = 1;
  1040. write_seqlock(&rename_lock);
  1041. goto again;
  1042. }
  1043. /*
  1044. * Search for at least 1 mount point in the dentry's subdirs.
  1045. * We descend to the next level whenever the d_subdirs
  1046. * list is non-empty and continue searching.
  1047. */
  1048. /**
  1049. * have_submounts - check for mounts over a dentry
  1050. * @parent: dentry to check.
  1051. *
  1052. * Return true if the parent or its subdirectories contain
  1053. * a mount point
  1054. */
  1055. static enum d_walk_ret check_mount(void *data, struct dentry *dentry)
  1056. {
  1057. int *ret = data;
  1058. if (d_mountpoint(dentry)) {
  1059. *ret = 1;
  1060. return D_WALK_QUIT;
  1061. }
  1062. return D_WALK_CONTINUE;
  1063. }
  1064. int have_submounts(struct dentry *parent)
  1065. {
  1066. int ret = 0;
  1067. d_walk(parent, &ret, check_mount, NULL);
  1068. return ret;
  1069. }
  1070. EXPORT_SYMBOL(have_submounts);
  1071. /*
  1072. * Search the dentry child list of the specified parent,
  1073. * and move any unused dentries to the end of the unused
  1074. * list for prune_dcache(). We descend to the next level
  1075. * whenever the d_subdirs list is non-empty and continue
  1076. * searching.
  1077. *
  1078. * It returns zero iff there are no unused children,
  1079. * otherwise it returns the number of children moved to
  1080. * the end of the unused list. This may not be the total
  1081. * number of unused children, because select_parent can
  1082. * drop the lock and return early due to latency
  1083. * constraints.
  1084. */
  1085. struct select_data {
  1086. struct dentry *start;
  1087. struct list_head dispose;
  1088. int found;
  1089. };
  1090. static enum d_walk_ret select_collect(void *_data, struct dentry *dentry)
  1091. {
  1092. struct select_data *data = _data;
  1093. enum d_walk_ret ret = D_WALK_CONTINUE;
  1094. if (data->start == dentry)
  1095. goto out;
  1096. /*
  1097. * move only zero ref count dentries to the dispose list.
  1098. *
  1099. * Those which are presently on the shrink list, being processed
  1100. * by shrink_dentry_list(), shouldn't be moved. Otherwise the
  1101. * loop in shrink_dcache_parent() might not make any progress
  1102. * and loop forever.
  1103. */
  1104. if (dentry->d_lockref.count) {
  1105. dentry_lru_del(dentry);
  1106. } else if (!(dentry->d_flags & DCACHE_SHRINK_LIST)) {
  1107. dentry_lru_move_list(dentry, &data->dispose);
  1108. dentry->d_flags |= DCACHE_SHRINK_LIST;
  1109. data->found++;
  1110. ret = D_WALK_NORETRY;
  1111. }
  1112. /*
  1113. * We can return to the caller if we have found some (this
  1114. * ensures forward progress). We'll be coming back to find
  1115. * the rest.
  1116. */
  1117. if (data->found && need_resched())
  1118. ret = D_WALK_QUIT;
  1119. out:
  1120. return ret;
  1121. }
  1122. /**
  1123. * shrink_dcache_parent - prune dcache
  1124. * @parent: parent of entries to prune
  1125. *
  1126. * Prune the dcache to remove unused children of the parent dentry.
  1127. */
  1128. void shrink_dcache_parent(struct dentry *parent)
  1129. {
  1130. for (;;) {
  1131. struct select_data data;
  1132. INIT_LIST_HEAD(&data.dispose);
  1133. data.start = parent;
  1134. data.found = 0;
  1135. d_walk(parent, &data, select_collect, NULL);
  1136. if (!data.found)
  1137. break;
  1138. shrink_dentry_list(&data.dispose);
  1139. cond_resched();
  1140. }
  1141. }
  1142. EXPORT_SYMBOL(shrink_dcache_parent);
  1143. static enum d_walk_ret check_and_collect(void *_data, struct dentry *dentry)
  1144. {
  1145. struct select_data *data = _data;
  1146. if (d_mountpoint(dentry)) {
  1147. data->found = -EBUSY;
  1148. return D_WALK_QUIT;
  1149. }
  1150. return select_collect(_data, dentry);
  1151. }
  1152. static void check_and_drop(void *_data)
  1153. {
  1154. struct select_data *data = _data;
  1155. if (d_mountpoint(data->start))
  1156. data->found = -EBUSY;
  1157. if (!data->found)
  1158. __d_drop(data->start);
  1159. }
  1160. /**
  1161. * check_submounts_and_drop - prune dcache, check for submounts and drop
  1162. *
  1163. * All done as a single atomic operation relative to has_unlinked_ancestor().
  1164. * Returns 0 if successfully unhashed @parent. If there were submounts then
  1165. * return -EBUSY.
  1166. *
  1167. * @dentry: dentry to prune and drop
  1168. */
  1169. int check_submounts_and_drop(struct dentry *dentry)
  1170. {
  1171. int ret = 0;
  1172. /* Negative dentries can be dropped without further checks */
  1173. if (!dentry->d_inode) {
  1174. d_drop(dentry);
  1175. goto out;
  1176. }
  1177. for (;;) {
  1178. struct select_data data;
  1179. INIT_LIST_HEAD(&data.dispose);
  1180. data.start = dentry;
  1181. data.found = 0;
  1182. d_walk(dentry, &data, check_and_collect, check_and_drop);
  1183. ret = data.found;
  1184. if (!list_empty(&data.dispose))
  1185. shrink_dentry_list(&data.dispose);
  1186. if (ret <= 0)
  1187. break;
  1188. cond_resched();
  1189. }
  1190. out:
  1191. return ret;
  1192. }
  1193. EXPORT_SYMBOL(check_submounts_and_drop);
  1194. /**
  1195. * __d_alloc - allocate a dcache entry
  1196. * @sb: filesystem it will belong to
  1197. * @name: qstr of the name
  1198. *
  1199. * Allocates a dentry. It returns %NULL if there is insufficient memory
  1200. * available. On a success the dentry is returned. The name passed in is
  1201. * copied and the copy passed in may be reused after this call.
  1202. */
  1203. struct dentry *__d_alloc(struct super_block *sb, const struct qstr *name)
  1204. {
  1205. struct dentry *dentry;
  1206. char *dname;
  1207. dentry = kmem_cache_alloc(dentry_cache, GFP_KERNEL);
  1208. if (!dentry)
  1209. return NULL;
  1210. /*
  1211. * We guarantee that the inline name is always NUL-terminated.
  1212. * This way the memcpy() done by the name switching in rename
  1213. * will still always have a NUL at the end, even if we might
  1214. * be overwriting an internal NUL character
  1215. */
  1216. dentry->d_iname[DNAME_INLINE_LEN-1] = 0;
  1217. if (name->len > DNAME_INLINE_LEN-1) {
  1218. dname = kmalloc(name->len + 1, GFP_KERNEL);
  1219. if (!dname) {
  1220. kmem_cache_free(dentry_cache, dentry);
  1221. return NULL;
  1222. }
  1223. } else {
  1224. dname = dentry->d_iname;
  1225. }
  1226. dentry->d_name.len = name->len;
  1227. dentry->d_name.hash = name->hash;
  1228. memcpy(dname, name->name, name->len);
  1229. dname[name->len] = 0;
  1230. /* Make sure we always see the terminating NUL character */
  1231. smp_wmb();
  1232. dentry->d_name.name = dname;
  1233. dentry->d_lockref.count = 1;
  1234. dentry->d_flags = 0;
  1235. spin_lock_init(&dentry->d_lock);
  1236. seqcount_init(&dentry->d_seq);
  1237. dentry->d_inode = NULL;
  1238. dentry->d_parent = dentry;
  1239. dentry->d_sb = sb;
  1240. dentry->d_op = NULL;
  1241. dentry->d_fsdata = NULL;
  1242. INIT_HLIST_BL_NODE(&dentry->d_hash);
  1243. INIT_LIST_HEAD(&dentry->d_lru);
  1244. INIT_LIST_HEAD(&dentry->d_subdirs);
  1245. INIT_HLIST_NODE(&dentry->d_alias);
  1246. INIT_LIST_HEAD(&dentry->d_u.d_child);
  1247. d_set_d_op(dentry, dentry->d_sb->s_d_op);
  1248. this_cpu_inc(nr_dentry);
  1249. return dentry;
  1250. }
  1251. /**
  1252. * d_alloc - allocate a dcache entry
  1253. * @parent: parent of entry to allocate
  1254. * @name: qstr of the name
  1255. *
  1256. * Allocates a dentry. It returns %NULL if there is insufficient memory
  1257. * available. On a success the dentry is returned. The name passed in is
  1258. * copied and the copy passed in may be reused after this call.
  1259. */
  1260. struct dentry *d_alloc(struct dentry * parent, const struct qstr *name)
  1261. {
  1262. struct dentry *dentry = __d_alloc(parent->d_sb, name);
  1263. if (!dentry)
  1264. return NULL;
  1265. spin_lock(&parent->d_lock);
  1266. /*
  1267. * don't need child lock because it is not subject
  1268. * to concurrency here
  1269. */
  1270. __dget_dlock(parent);
  1271. dentry->d_parent = parent;
  1272. list_add(&dentry->d_u.d_child, &parent->d_subdirs);
  1273. spin_unlock(&parent->d_lock);
  1274. return dentry;
  1275. }
  1276. EXPORT_SYMBOL(d_alloc);
  1277. struct dentry *d_alloc_pseudo(struct super_block *sb, const struct qstr *name)
  1278. {
  1279. struct dentry *dentry = __d_alloc(sb, name);
  1280. if (dentry)
  1281. dentry->d_flags |= DCACHE_DISCONNECTED;
  1282. return dentry;
  1283. }
  1284. EXPORT_SYMBOL(d_alloc_pseudo);
  1285. struct dentry *d_alloc_name(struct dentry *parent, const char *name)
  1286. {
  1287. struct qstr q;
  1288. q.name = name;
  1289. q.len = strlen(name);
  1290. q.hash = full_name_hash(q.name, q.len);
  1291. return d_alloc(parent, &q);
  1292. }
  1293. EXPORT_SYMBOL(d_alloc_name);
  1294. void d_set_d_op(struct dentry *dentry, const struct dentry_operations *op)
  1295. {
  1296. WARN_ON_ONCE(dentry->d_op);
  1297. WARN_ON_ONCE(dentry->d_flags & (DCACHE_OP_HASH |
  1298. DCACHE_OP_COMPARE |
  1299. DCACHE_OP_REVALIDATE |
  1300. DCACHE_OP_WEAK_REVALIDATE |
  1301. DCACHE_OP_DELETE ));
  1302. dentry->d_op = op;
  1303. if (!op)
  1304. return;
  1305. if (op->d_hash)
  1306. dentry->d_flags |= DCACHE_OP_HASH;
  1307. if (op->d_compare)
  1308. dentry->d_flags |= DCACHE_OP_COMPARE;
  1309. if (op->d_revalidate)
  1310. dentry->d_flags |= DCACHE_OP_REVALIDATE;
  1311. if (op->d_weak_revalidate)
  1312. dentry->d_flags |= DCACHE_OP_WEAK_REVALIDATE;
  1313. if (op->d_delete)
  1314. dentry->d_flags |= DCACHE_OP_DELETE;
  1315. if (op->d_prune)
  1316. dentry->d_flags |= DCACHE_OP_PRUNE;
  1317. }
  1318. EXPORT_SYMBOL(d_set_d_op);
  1319. static void __d_instantiate(struct dentry *dentry, struct inode *inode)
  1320. {
  1321. spin_lock(&dentry->d_lock);
  1322. if (inode) {
  1323. if (unlikely(IS_AUTOMOUNT(inode)))
  1324. dentry->d_flags |= DCACHE_NEED_AUTOMOUNT;
  1325. hlist_add_head(&dentry->d_alias, &inode->i_dentry);
  1326. }
  1327. dentry->d_inode = inode;
  1328. dentry_rcuwalk_barrier(dentry);
  1329. spin_unlock(&dentry->d_lock);
  1330. fsnotify_d_instantiate(dentry, inode);
  1331. }
  1332. /**
  1333. * d_instantiate - fill in inode information for a dentry
  1334. * @entry: dentry to complete
  1335. * @inode: inode to attach to this dentry
  1336. *
  1337. * Fill in inode information in the entry.
  1338. *
  1339. * This turns negative dentries into productive full members
  1340. * of society.
  1341. *
  1342. * NOTE! This assumes that the inode count has been incremented
  1343. * (or otherwise set) by the caller to indicate that it is now
  1344. * in use by the dcache.
  1345. */
  1346. void d_instantiate(struct dentry *entry, struct inode * inode)
  1347. {
  1348. BUG_ON(!hlist_unhashed(&entry->d_alias));
  1349. if (inode)
  1350. spin_lock(&inode->i_lock);
  1351. __d_instantiate(entry, inode);
  1352. if (inode)
  1353. spin_unlock(&inode->i_lock);
  1354. security_d_instantiate(entry, inode);
  1355. }
  1356. EXPORT_SYMBOL(d_instantiate);
  1357. /**
  1358. * d_instantiate_unique - instantiate a non-aliased dentry
  1359. * @entry: dentry to instantiate
  1360. * @inode: inode to attach to this dentry
  1361. *
  1362. * Fill in inode information in the entry. On success, it returns NULL.
  1363. * If an unhashed alias of "entry" already exists, then we return the
  1364. * aliased dentry instead and drop one reference to inode.
  1365. *
  1366. * Note that in order to avoid conflicts with rename() etc, the caller
  1367. * had better be holding the parent directory semaphore.
  1368. *
  1369. * This also assumes that the inode count has been incremented
  1370. * (or otherwise set) by the caller to indicate that it is now
  1371. * in use by the dcache.
  1372. */
  1373. static struct dentry *__d_instantiate_unique(struct dentry *entry,
  1374. struct inode *inode)
  1375. {
  1376. struct dentry *alias;
  1377. int len = entry->d_name.len;
  1378. const char *name = entry->d_name.name;
  1379. unsigned int hash = entry->d_name.hash;
  1380. if (!inode) {
  1381. __d_instantiate(entry, NULL);
  1382. return NULL;
  1383. }
  1384. hlist_for_each_entry(alias, &inode->i_dentry, d_alias) {
  1385. /*
  1386. * Don't need alias->d_lock here, because aliases with
  1387. * d_parent == entry->d_parent are not subject to name or
  1388. * parent changes, because the parent inode i_mutex is held.
  1389. */
  1390. if (alias->d_name.hash != hash)
  1391. continue;
  1392. if (alias->d_parent != entry->d_parent)
  1393. continue;
  1394. if (alias->d_name.len != len)
  1395. continue;
  1396. if (dentry_cmp(alias, name, len))
  1397. continue;
  1398. __dget(alias);
  1399. return alias;
  1400. }
  1401. __d_instantiate(entry, inode);
  1402. return NULL;
  1403. }
  1404. struct dentry *d_instantiate_unique(struct dentry *entry, struct inode *inode)
  1405. {
  1406. struct dentry *result;
  1407. BUG_ON(!hlist_unhashed(&entry->d_alias));
  1408. if (inode)
  1409. spin_lock(&inode->i_lock);
  1410. result = __d_instantiate_unique(entry, inode);
  1411. if (inode)
  1412. spin_unlock(&inode->i_lock);
  1413. if (!result) {
  1414. security_d_instantiate(entry, inode);
  1415. return NULL;
  1416. }
  1417. BUG_ON(!d_unhashed(result));
  1418. iput(inode);
  1419. return result;
  1420. }
  1421. EXPORT_SYMBOL(d_instantiate_unique);
  1422. struct dentry *d_make_root(struct inode *root_inode)
  1423. {
  1424. struct dentry *res = NULL;
  1425. if (root_inode) {
  1426. static const struct qstr name = QSTR_INIT("/", 1);
  1427. res = __d_alloc(root_inode->i_sb, &name);
  1428. if (res)
  1429. d_instantiate(res, root_inode);
  1430. else
  1431. iput(root_inode);
  1432. }
  1433. return res;
  1434. }
  1435. EXPORT_SYMBOL(d_make_root);
  1436. static struct dentry * __d_find_any_alias(struct inode *inode)
  1437. {
  1438. struct dentry *alias;
  1439. if (hlist_empty(&inode->i_dentry))
  1440. return NULL;
  1441. alias = hlist_entry(inode->i_dentry.first, struct dentry, d_alias);
  1442. __dget(alias);
  1443. return alias;
  1444. }
  1445. /**
  1446. * d_find_any_alias - find any alias for a given inode
  1447. * @inode: inode to find an alias for
  1448. *
  1449. * If any aliases exist for the given inode, take and return a
  1450. * reference for one of them. If no aliases exist, return %NULL.
  1451. */
  1452. struct dentry *d_find_any_alias(struct inode *inode)
  1453. {
  1454. struct dentry *de;
  1455. spin_lock(&inode->i_lock);
  1456. de = __d_find_any_alias(inode);
  1457. spin_unlock(&inode->i_lock);
  1458. return de;
  1459. }
  1460. EXPORT_SYMBOL(d_find_any_alias);
  1461. /**
  1462. * d_obtain_alias - find or allocate a dentry for a given inode
  1463. * @inode: inode to allocate the dentry for
  1464. *
  1465. * Obtain a dentry for an inode resulting from NFS filehandle conversion or
  1466. * similar open by handle operations. The returned dentry may be anonymous,
  1467. * or may have a full name (if the inode was already in the cache).
  1468. *
  1469. * When called on a directory inode, we must ensure that the inode only ever
  1470. * has one dentry. If a dentry is found, that is returned instead of
  1471. * allocating a new one.
  1472. *
  1473. * On successful return, the reference to the inode has been transferred
  1474. * to the dentry. In case of an error the reference on the inode is released.
  1475. * To make it easier to use in export operations a %NULL or IS_ERR inode may
  1476. * be passed in and will be the error will be propagate to the return value,
  1477. * with a %NULL @inode replaced by ERR_PTR(-ESTALE).
  1478. */
  1479. struct dentry *d_obtain_alias(struct inode *inode)
  1480. {
  1481. static const struct qstr anonstring = QSTR_INIT("/", 1);
  1482. struct dentry *tmp;
  1483. struct dentry *res;
  1484. if (!inode)
  1485. return ERR_PTR(-ESTALE);
  1486. if (IS_ERR(inode))
  1487. return ERR_CAST(inode);
  1488. res = d_find_any_alias(inode);
  1489. if (res)
  1490. goto out_iput;
  1491. tmp = __d_alloc(inode->i_sb, &anonstring);
  1492. if (!tmp) {
  1493. res = ERR_PTR(-ENOMEM);
  1494. goto out_iput;
  1495. }
  1496. spin_lock(&inode->i_lock);
  1497. res = __d_find_any_alias(inode);
  1498. if (res) {
  1499. spin_unlock(&inode->i_lock);
  1500. dput(tmp);
  1501. goto out_iput;
  1502. }
  1503. /* attach a disconnected dentry */
  1504. spin_lock(&tmp->d_lock);
  1505. tmp->d_inode = inode;
  1506. tmp->d_flags |= DCACHE_DISCONNECTED;
  1507. hlist_add_head(&tmp->d_alias, &inode->i_dentry);
  1508. hlist_bl_lock(&tmp->d_sb->s_anon);
  1509. hlist_bl_add_head(&tmp->d_hash, &tmp->d_sb->s_anon);
  1510. hlist_bl_unlock(&tmp->d_sb->s_anon);
  1511. spin_unlock(&tmp->d_lock);
  1512. spin_unlock(&inode->i_lock);
  1513. security_d_instantiate(tmp, inode);
  1514. return tmp;
  1515. out_iput:
  1516. if (res && !IS_ERR(res))
  1517. security_d_instantiate(res, inode);
  1518. iput(inode);
  1519. return res;
  1520. }
  1521. EXPORT_SYMBOL(d_obtain_alias);
  1522. /**
  1523. * d_splice_alias - splice a disconnected dentry into the tree if one exists
  1524. * @inode: the inode which may have a disconnected dentry
  1525. * @dentry: a negative dentry which we want to point to the inode.
  1526. *
  1527. * If inode is a directory and has a 'disconnected' dentry (i.e. IS_ROOT and
  1528. * DCACHE_DISCONNECTED), then d_move that in place of the given dentry
  1529. * and return it, else simply d_add the inode to the dentry and return NULL.
  1530. *
  1531. * This is needed in the lookup routine of any filesystem that is exportable
  1532. * (via knfsd) so that we can build dcache paths to directories effectively.
  1533. *
  1534. * If a dentry was found and moved, then it is returned. Otherwise NULL
  1535. * is returned. This matches the expected return value of ->lookup.
  1536. *
  1537. * Cluster filesystems may call this function with a negative, hashed dentry.
  1538. * In that case, we know that the inode will be a regular file, and also this
  1539. * will only occur during atomic_open. So we need to check for the dentry
  1540. * being already hashed only in the final case.
  1541. */
  1542. struct dentry *d_splice_alias(struct inode *inode, struct dentry *dentry)
  1543. {
  1544. struct dentry *new = NULL;
  1545. if (IS_ERR(inode))
  1546. return ERR_CAST(inode);
  1547. if (inode && S_ISDIR(inode->i_mode)) {
  1548. spin_lock(&inode->i_lock);
  1549. new = __d_find_alias(inode, 1);
  1550. if (new) {
  1551. BUG_ON(!(new->d_flags & DCACHE_DISCONNECTED));
  1552. spin_unlock(&inode->i_lock);
  1553. security_d_instantiate(new, inode);
  1554. d_move(new, dentry);
  1555. iput(inode);
  1556. } else {
  1557. /* already taking inode->i_lock, so d_add() by hand */
  1558. __d_instantiate(dentry, inode);
  1559. spin_unlock(&inode->i_lock);
  1560. security_d_instantiate(dentry, inode);
  1561. d_rehash(dentry);
  1562. }
  1563. } else {
  1564. d_instantiate(dentry, inode);
  1565. if (d_unhashed(dentry))
  1566. d_rehash(dentry);
  1567. }
  1568. return new;
  1569. }
  1570. EXPORT_SYMBOL(d_splice_alias);
  1571. /**
  1572. * d_add_ci - lookup or allocate new dentry with case-exact name
  1573. * @inode: the inode case-insensitive lookup has found
  1574. * @dentry: the negative dentry that was passed to the parent's lookup func
  1575. * @name: the case-exact name to be associated with the returned dentry
  1576. *
  1577. * This is to avoid filling the dcache with case-insensitive names to the
  1578. * same inode, only the actual correct case is stored in the dcache for
  1579. * case-insensitive filesystems.
  1580. *
  1581. * For a case-insensitive lookup match and if the the case-exact dentry
  1582. * already exists in in the dcache, use it and return it.
  1583. *
  1584. * If no entry exists with the exact case name, allocate new dentry with
  1585. * the exact case, and return the spliced entry.
  1586. */
  1587. struct dentry *d_add_ci(struct dentry *dentry, struct inode *inode,
  1588. struct qstr *name)
  1589. {
  1590. struct dentry *found;
  1591. struct dentry *new;
  1592. /*
  1593. * First check if a dentry matching the name already exists,
  1594. * if not go ahead and create it now.
  1595. */
  1596. found = d_hash_and_lookup(dentry->d_parent, name);
  1597. if (unlikely(IS_ERR(found)))
  1598. goto err_out;
  1599. if (!found) {
  1600. new = d_alloc(dentry->d_parent, name);
  1601. if (!new) {
  1602. found = ERR_PTR(-ENOMEM);
  1603. goto err_out;
  1604. }
  1605. found = d_splice_alias(inode, new);
  1606. if (found) {
  1607. dput(new);
  1608. return found;
  1609. }
  1610. return new;
  1611. }
  1612. /*
  1613. * If a matching dentry exists, and it's not negative use it.
  1614. *
  1615. * Decrement the reference count to balance the iget() done
  1616. * earlier on.
  1617. */
  1618. if (found->d_inode) {
  1619. if (unlikely(found->d_inode != inode)) {
  1620. /* This can't happen because bad inodes are unhashed. */
  1621. BUG_ON(!is_bad_inode(inode));
  1622. BUG_ON(!is_bad_inode(found->d_inode));
  1623. }
  1624. iput(inode);
  1625. return found;
  1626. }
  1627. /*
  1628. * Negative dentry: instantiate it unless the inode is a directory and
  1629. * already has a dentry.
  1630. */
  1631. new = d_splice_alias(inode, found);
  1632. if (new) {
  1633. dput(found);
  1634. found = new;
  1635. }
  1636. return found;
  1637. err_out:
  1638. iput(inode);
  1639. return found;
  1640. }
  1641. EXPORT_SYMBOL(d_add_ci);
  1642. /*
  1643. * Do the slow-case of the dentry name compare.
  1644. *
  1645. * Unlike the dentry_cmp() function, we need to atomically
  1646. * load the name and length information, so that the
  1647. * filesystem can rely on them, and can use the 'name' and
  1648. * 'len' information without worrying about walking off the
  1649. * end of memory etc.
  1650. *
  1651. * Thus the read_seqcount_retry() and the "duplicate" info
  1652. * in arguments (the low-level filesystem should not look
  1653. * at the dentry inode or name contents directly, since
  1654. * rename can change them while we're in RCU mode).
  1655. */
  1656. enum slow_d_compare {
  1657. D_COMP_OK,
  1658. D_COMP_NOMATCH,
  1659. D_COMP_SEQRETRY,
  1660. };
  1661. static noinline enum slow_d_compare slow_dentry_cmp(
  1662. const struct dentry *parent,
  1663. struct dentry *dentry,
  1664. unsigned int seq,
  1665. const struct qstr *name)
  1666. {
  1667. int tlen = dentry->d_name.len;
  1668. const char *tname = dentry->d_name.name;
  1669. if (read_seqcount_retry(&dentry->d_seq, seq)) {
  1670. cpu_relax();
  1671. return D_COMP_SEQRETRY;
  1672. }
  1673. if (parent->d_op->d_compare(parent, dentry, tlen, tname, name))
  1674. return D_COMP_NOMATCH;
  1675. return D_COMP_OK;
  1676. }
  1677. /**
  1678. * __d_lookup_rcu - search for a dentry (racy, store-free)
  1679. * @parent: parent dentry
  1680. * @name: qstr of name we wish to find
  1681. * @seqp: returns d_seq value at the point where the dentry was found
  1682. * Returns: dentry, or NULL
  1683. *
  1684. * __d_lookup_rcu is the dcache lookup function for rcu-walk name
  1685. * resolution (store-free path walking) design described in
  1686. * Documentation/filesystems/path-lookup.txt.
  1687. *
  1688. * This is not to be used outside core vfs.
  1689. *
  1690. * __d_lookup_rcu must only be used in rcu-walk mode, ie. with vfsmount lock
  1691. * held, and rcu_read_lock held. The returned dentry must not be stored into
  1692. * without taking d_lock and checking d_seq sequence count against @seq
  1693. * returned here.
  1694. *
  1695. * A refcount may be taken on the found dentry with the d_rcu_to_refcount
  1696. * function.
  1697. *
  1698. * Alternatively, __d_lookup_rcu may be called again to look up the child of
  1699. * the returned dentry, so long as its parent's seqlock is checked after the
  1700. * child is looked up. Thus, an interlocking stepping of sequence lock checks
  1701. * is formed, giving integrity down the path walk.
  1702. *
  1703. * NOTE! The caller *has* to check the resulting dentry against the sequence
  1704. * number we've returned before using any of the resulting dentry state!
  1705. */
  1706. struct dentry *__d_lookup_rcu(const struct dentry *parent,
  1707. const struct qstr *name,
  1708. unsigned *seqp)
  1709. {
  1710. u64 hashlen = name->hash_len;
  1711. const unsigned char *str = name->name;
  1712. struct hlist_bl_head *b = d_hash(parent, hashlen_hash(hashlen));
  1713. struct hlist_bl_node *node;
  1714. struct dentry *dentry;
  1715. /*
  1716. * Note: There is significant duplication with __d_lookup_rcu which is
  1717. * required to prevent single threaded performance regressions
  1718. * especially on architectures where smp_rmb (in seqcounts) are costly.
  1719. * Keep the two functions in sync.
  1720. */
  1721. /*
  1722. * The hash list is protected using RCU.
  1723. *
  1724. * Carefully use d_seq when comparing a candidate dentry, to avoid
  1725. * races with d_move().
  1726. *
  1727. * It is possible that concurrent renames can mess up our list
  1728. * walk here and result in missing our dentry, resulting in the
  1729. * false-negative result. d_lookup() protects against concurrent
  1730. * renames using rename_lock seqlock.
  1731. *
  1732. * See Documentation/filesystems/path-lookup.txt for more details.
  1733. */
  1734. hlist_bl_for_each_entry_rcu(dentry, node, b, d_hash) {
  1735. unsigned seq;
  1736. seqretry:
  1737. /*
  1738. * The dentry sequence count protects us from concurrent
  1739. * renames, and thus protects parent and name fields.
  1740. *
  1741. * The caller must perform a seqcount check in order
  1742. * to do anything useful with the returned dentry.
  1743. *
  1744. * NOTE! We do a "raw" seqcount_begin here. That means that
  1745. * we don't wait for the sequence count to stabilize if it
  1746. * is in the middle of a sequence change. If we do the slow
  1747. * dentry compare, we will do seqretries until it is stable,
  1748. * and if we end up with a successful lookup, we actually
  1749. * want to exit RCU lookup anyway.
  1750. */
  1751. seq = raw_seqcount_begin(&dentry->d_seq);
  1752. if (dentry->d_parent != parent)
  1753. continue;
  1754. if (d_unhashed(dentry))
  1755. continue;
  1756. if (unlikely(parent->d_flags & DCACHE_OP_COMPARE)) {
  1757. if (dentry->d_name.hash != hashlen_hash(hashlen))
  1758. continue;
  1759. *seqp = seq;
  1760. switch (slow_dentry_cmp(parent, dentry, seq, name)) {
  1761. case D_COMP_OK:
  1762. return dentry;
  1763. case D_COMP_NOMATCH:
  1764. continue;
  1765. default:
  1766. goto seqretry;
  1767. }
  1768. }
  1769. if (dentry->d_name.hash_len != hashlen)
  1770. continue;
  1771. *seqp = seq;
  1772. if (!dentry_cmp(dentry, str, hashlen_len(hashlen)))
  1773. return dentry;
  1774. }
  1775. return NULL;
  1776. }
  1777. /**
  1778. * d_lookup - search for a dentry
  1779. * @parent: parent dentry
  1780. * @name: qstr of name we wish to find
  1781. * Returns: dentry, or NULL
  1782. *
  1783. * d_lookup searches the children of the parent dentry for the name in
  1784. * question. If the dentry is found its reference count is incremented and the
  1785. * dentry is returned. The caller must use dput to free the entry when it has
  1786. * finished using it. %NULL is returned if the dentry does not exist.
  1787. */
  1788. struct dentry *d_lookup(const struct dentry *parent, const struct qstr *name)
  1789. {
  1790. struct dentry *dentry;
  1791. unsigned seq;
  1792. do {
  1793. seq = read_seqbegin(&rename_lock);
  1794. dentry = __d_lookup(parent, name);
  1795. if (dentry)
  1796. break;
  1797. } while (read_seqretry(&rename_lock, seq));
  1798. return dentry;
  1799. }
  1800. EXPORT_SYMBOL(d_lookup);
  1801. /**
  1802. * __d_lookup - search for a dentry (racy)
  1803. * @parent: parent dentry
  1804. * @name: qstr of name we wish to find
  1805. * Returns: dentry, or NULL
  1806. *
  1807. * __d_lookup is like d_lookup, however it may (rarely) return a
  1808. * false-negative result due to unrelated rename activity.
  1809. *
  1810. * __d_lookup is slightly faster by avoiding rename_lock read seqlock,
  1811. * however it must be used carefully, eg. with a following d_lookup in
  1812. * the case of failure.
  1813. *
  1814. * __d_lookup callers must be commented.
  1815. */
  1816. struct dentry *__d_lookup(const struct dentry *parent, const struct qstr *name)
  1817. {
  1818. unsigned int len = name->len;
  1819. unsigned int hash = name->hash;
  1820. const unsigned char *str = name->name;
  1821. struct hlist_bl_head *b = d_hash(parent, hash);
  1822. struct hlist_bl_node *node;
  1823. struct dentry *found = NULL;
  1824. struct dentry *dentry;
  1825. /*
  1826. * Note: There is significant duplication with __d_lookup_rcu which is
  1827. * required to prevent single threaded performance regressions
  1828. * especially on architectures where smp_rmb (in seqcounts) are costly.
  1829. * Keep the two functions in sync.
  1830. */
  1831. /*
  1832. * The hash list is protected using RCU.
  1833. *
  1834. * Take d_lock when comparing a candidate dentry, to avoid races
  1835. * with d_move().
  1836. *
  1837. * It is possible that concurrent renames can mess up our list
  1838. * walk here and result in missing our dentry, resulting in the
  1839. * false-negative result. d_lookup() protects against concurrent
  1840. * renames using rename_lock seqlock.
  1841. *
  1842. * See Documentation/filesystems/path-lookup.txt for more details.
  1843. */
  1844. rcu_read_lock();
  1845. hlist_bl_for_each_entry_rcu(dentry, node, b, d_hash) {
  1846. if (dentry->d_name.hash != hash)
  1847. continue;
  1848. spin_lock(&dentry->d_lock);
  1849. if (dentry->d_parent != parent)
  1850. goto next;
  1851. if (d_unhashed(dentry))
  1852. goto next;
  1853. /*
  1854. * It is safe to compare names since d_move() cannot
  1855. * change the qstr (protected by d_lock).
  1856. */
  1857. if (parent->d_flags & DCACHE_OP_COMPARE) {
  1858. int tlen = dentry->d_name.len;
  1859. const char *tname = dentry->d_name.name;
  1860. if (parent->d_op->d_compare(parent, dentry, tlen, tname, name))
  1861. goto next;
  1862. } else {
  1863. if (dentry->d_name.len != len)
  1864. goto next;
  1865. if (dentry_cmp(dentry, str, len))
  1866. goto next;
  1867. }
  1868. dentry->d_lockref.count++;
  1869. found = dentry;
  1870. spin_unlock(&dentry->d_lock);
  1871. break;
  1872. next:
  1873. spin_unlock(&dentry->d_lock);
  1874. }
  1875. rcu_read_unlock();
  1876. return found;
  1877. }
  1878. /**
  1879. * d_hash_and_lookup - hash the qstr then search for a dentry
  1880. * @dir: Directory to search in
  1881. * @name: qstr of name we wish to find
  1882. *
  1883. * On lookup failure NULL is returned; on bad name - ERR_PTR(-error)
  1884. */
  1885. struct dentry *d_hash_and_lookup(struct dentry *dir, struct qstr *name)
  1886. {
  1887. /*
  1888. * Check for a fs-specific hash function. Note that we must
  1889. * calculate the standard hash first, as the d_op->d_hash()
  1890. * routine may choose to leave the hash value unchanged.
  1891. */
  1892. name->hash = full_name_hash(name->name, name->len);
  1893. if (dir->d_flags & DCACHE_OP_HASH) {
  1894. int err = dir->d_op->d_hash(dir, name);
  1895. if (unlikely(err < 0))
  1896. return ERR_PTR(err);
  1897. }
  1898. return d_lookup(dir, name);
  1899. }
  1900. EXPORT_SYMBOL(d_hash_and_lookup);
  1901. /**
  1902. * d_validate - verify dentry provided from insecure source (deprecated)
  1903. * @dentry: The dentry alleged to be valid child of @dparent
  1904. * @dparent: The parent dentry (known to be valid)
  1905. *
  1906. * An insecure source has sent us a dentry, here we verify it and dget() it.
  1907. * This is used by ncpfs in its readdir implementation.
  1908. * Zero is returned in the dentry is invalid.
  1909. *
  1910. * This function is slow for big directories, and deprecated, do not use it.
  1911. */
  1912. int d_validate(struct dentry *dentry, struct dentry *dparent)
  1913. {
  1914. struct dentry *child;
  1915. spin_lock(&dparent->d_lock);
  1916. list_for_each_entry(child, &dparent->d_subdirs, d_u.d_child) {
  1917. if (dentry == child) {
  1918. spin_lock_nested(&dentry->d_lock, DENTRY_D_LOCK_NESTED);
  1919. __dget_dlock(dentry);
  1920. spin_unlock(&dentry->d_lock);
  1921. spin_unlock(&dparent->d_lock);
  1922. return 1;
  1923. }
  1924. }
  1925. spin_unlock(&dparent->d_lock);
  1926. return 0;
  1927. }
  1928. EXPORT_SYMBOL(d_validate);
  1929. /*
  1930. * When a file is deleted, we have two options:
  1931. * - turn this dentry into a negative dentry
  1932. * - unhash this dentry and free it.
  1933. *
  1934. * Usually, we want to just turn this into
  1935. * a negative dentry, but if anybody else is
  1936. * currently using the dentry or the inode
  1937. * we can't do that and we fall back on removing
  1938. * it from the hash queues and waiting for
  1939. * it to be deleted later when it has no users
  1940. */
  1941. /**
  1942. * d_delete - delete a dentry
  1943. * @dentry: The dentry to delete
  1944. *
  1945. * Turn the dentry into a negative dentry if possible, otherwise
  1946. * remove it from the hash queues so it can be deleted later
  1947. */
  1948. void d_delete(struct dentry * dentry)
  1949. {
  1950. struct inode *inode;
  1951. int isdir = 0;
  1952. /*
  1953. * Are we the only user?
  1954. */
  1955. again:
  1956. spin_lock(&dentry->d_lock);
  1957. inode = dentry->d_inode;
  1958. isdir = S_ISDIR(inode->i_mode);
  1959. if (dentry->d_lockref.count == 1) {
  1960. if (!spin_trylock(&inode->i_lock)) {
  1961. spin_unlock(&dentry->d_lock);
  1962. cpu_relax();
  1963. goto again;
  1964. }
  1965. dentry->d_flags &= ~DCACHE_CANT_MOUNT;
  1966. dentry_unlink_inode(dentry);
  1967. fsnotify_nameremove(dentry, isdir);
  1968. return;
  1969. }
  1970. if (!d_unhashed(dentry))
  1971. __d_drop(dentry);
  1972. spin_unlock(&dentry->d_lock);
  1973. fsnotify_nameremove(dentry, isdir);
  1974. }
  1975. EXPORT_SYMBOL(d_delete);
  1976. static void __d_rehash(struct dentry * entry, struct hlist_bl_head *b)
  1977. {
  1978. BUG_ON(!d_unhashed(entry));
  1979. hlist_bl_lock(b);
  1980. entry->d_flags |= DCACHE_RCUACCESS;
  1981. hlist_bl_add_head_rcu(&entry->d_hash, b);
  1982. hlist_bl_unlock(b);
  1983. }
  1984. static void _d_rehash(struct dentry * entry)
  1985. {
  1986. __d_rehash(entry, d_hash(entry->d_parent, entry->d_name.hash));
  1987. }
  1988. /**
  1989. * d_rehash - add an entry back to the hash
  1990. * @entry: dentry to add to the hash
  1991. *
  1992. * Adds a dentry to the hash according to its name.
  1993. */
  1994. void d_rehash(struct dentry * entry)
  1995. {
  1996. spin_lock(&entry->d_lock);
  1997. _d_rehash(entry);
  1998. spin_unlock(&entry->d_lock);
  1999. }
  2000. EXPORT_SYMBOL(d_rehash);
  2001. /**
  2002. * dentry_update_name_case - update case insensitive dentry with a new name
  2003. * @dentry: dentry to be updated
  2004. * @name: new name
  2005. *
  2006. * Update a case insensitive dentry with new case of name.
  2007. *
  2008. * dentry must have been returned by d_lookup with name @name. Old and new
  2009. * name lengths must match (ie. no d_compare which allows mismatched name
  2010. * lengths).
  2011. *
  2012. * Parent inode i_mutex must be held over d_lookup and into this call (to
  2013. * keep renames and concurrent inserts, and readdir(2) away).
  2014. */
  2015. void dentry_update_name_case(struct dentry *dentry, struct qstr *name)
  2016. {
  2017. BUG_ON(!mutex_is_locked(&dentry->d_parent->d_inode->i_mutex));
  2018. BUG_ON(dentry->d_name.len != name->len); /* d_lookup gives this */
  2019. spin_lock(&dentry->d_lock);
  2020. write_seqcount_begin(&dentry->d_seq);
  2021. memcpy((unsigned char *)dentry->d_name.name, name->name, name->len);
  2022. write_seqcount_end(&dentry->d_seq);
  2023. spin_unlock(&dentry->d_lock);
  2024. }
  2025. EXPORT_SYMBOL(dentry_update_name_case);
  2026. static void switch_names(struct dentry *dentry, struct dentry *target)
  2027. {
  2028. if (dname_external(target)) {
  2029. if (dname_external(dentry)) {
  2030. /*
  2031. * Both external: swap the pointers
  2032. */
  2033. swap(target->d_name.name, dentry->d_name.name);
  2034. } else {
  2035. /*
  2036. * dentry:internal, target:external. Steal target's
  2037. * storage and make target internal.
  2038. */
  2039. memcpy(target->d_iname, dentry->d_name.name,
  2040. dentry->d_name.len + 1);
  2041. dentry->d_name.name = target->d_name.name;
  2042. target->d_name.name = target->d_iname;
  2043. }
  2044. } else {
  2045. if (dname_external(dentry)) {
  2046. /*
  2047. * dentry:external, target:internal. Give dentry's
  2048. * storage to target and make dentry internal
  2049. */
  2050. memcpy(dentry->d_iname, target->d_name.name,
  2051. target->d_name.len + 1);
  2052. target->d_name.name = dentry->d_name.name;
  2053. dentry->d_name.name = dentry->d_iname;
  2054. } else {
  2055. /*
  2056. * Both are internal. Just copy target to dentry
  2057. */
  2058. memcpy(dentry->d_iname, target->d_name.name,
  2059. target->d_name.len + 1);
  2060. dentry->d_name.len = target->d_name.len;
  2061. return;
  2062. }
  2063. }
  2064. swap(dentry->d_name.len, target->d_name.len);
  2065. }
  2066. static void dentry_lock_for_move(struct dentry *dentry, struct dentry *target)
  2067. {
  2068. /*
  2069. * XXXX: do we really need to take target->d_lock?
  2070. */
  2071. if (IS_ROOT(dentry) || dentry->d_parent == target->d_parent)
  2072. spin_lock(&target->d_parent->d_lock);
  2073. else {
  2074. if (d_ancestor(dentry->d_parent, target->d_parent)) {
  2075. spin_lock(&dentry->d_parent->d_lock);
  2076. spin_lock_nested(&target->d_parent->d_lock,
  2077. DENTRY_D_LOCK_NESTED);
  2078. } else {
  2079. spin_lock(&target->d_parent->d_lock);
  2080. spin_lock_nested(&dentry->d_parent->d_lock,
  2081. DENTRY_D_LOCK_NESTED);
  2082. }
  2083. }
  2084. if (target < dentry) {
  2085. spin_lock_nested(&target->d_lock, 2);
  2086. spin_lock_nested(&dentry->d_lock, 3);
  2087. } else {
  2088. spin_lock_nested(&dentry->d_lock, 2);
  2089. spin_lock_nested(&target->d_lock, 3);
  2090. }
  2091. }
  2092. static void dentry_unlock_parents_for_move(struct dentry *dentry,
  2093. struct dentry *target)
  2094. {
  2095. if (target->d_parent != dentry->d_parent)
  2096. spin_unlock(&dentry->d_parent->d_lock);
  2097. if (target->d_parent != target)
  2098. spin_unlock(&target->d_parent->d_lock);
  2099. }
  2100. /*
  2101. * When switching names, the actual string doesn't strictly have to
  2102. * be preserved in the target - because we're dropping the target
  2103. * anyway. As such, we can just do a simple memcpy() to copy over
  2104. * the new name before we switch.
  2105. *
  2106. * Note that we have to be a lot more careful about getting the hash
  2107. * switched - we have to switch the hash value properly even if it
  2108. * then no longer matches the actual (corrupted) string of the target.
  2109. * The hash value has to match the hash queue that the dentry is on..
  2110. */
  2111. /*
  2112. * __d_move - move a dentry
  2113. * @dentry: entry to move
  2114. * @target: new dentry
  2115. *
  2116. * Update the dcache to reflect the move of a file name. Negative
  2117. * dcache entries should not be moved in this way. Caller must hold
  2118. * rename_lock, the i_mutex of the source and target directories,
  2119. * and the sb->s_vfs_rename_mutex if they differ. See lock_rename().
  2120. */
  2121. static void __d_move(struct dentry * dentry, struct dentry * target)
  2122. {
  2123. if (!dentry->d_inode)
  2124. printk(KERN_WARNING "VFS: moving negative dcache entry\n");
  2125. BUG_ON(d_ancestor(dentry, target));
  2126. BUG_ON(d_ancestor(target, dentry));
  2127. dentry_lock_for_move(dentry, target);
  2128. write_seqcount_begin(&dentry->d_seq);
  2129. write_seqcount_begin(&target->d_seq);
  2130. /* __d_drop does write_seqcount_barrier, but they're OK to nest. */
  2131. /*
  2132. * Move the dentry to the target hash queue. Don't bother checking
  2133. * for the same hash queue because of how unlikely it is.
  2134. */
  2135. __d_drop(dentry);
  2136. __d_rehash(dentry, d_hash(target->d_parent, target->d_name.hash));
  2137. /* Unhash the target: dput() will then get rid of it */
  2138. __d_drop(target);
  2139. list_del(&dentry->d_u.d_child);
  2140. list_del(&target->d_u.d_child);
  2141. /* Switch the names.. */
  2142. switch_names(dentry, target);
  2143. swap(dentry->d_name.hash, target->d_name.hash);
  2144. /* ... and switch the parents */
  2145. if (IS_ROOT(dentry)) {
  2146. dentry->d_parent = target->d_parent;
  2147. target->d_parent = target;
  2148. INIT_LIST_HEAD(&target->d_u.d_child);
  2149. } else {
  2150. swap(dentry->d_parent, target->d_parent);
  2151. /* And add them back to the (new) parent lists */
  2152. list_add(&target->d_u.d_child, &target->d_parent->d_subdirs);
  2153. }
  2154. list_add(&dentry->d_u.d_child, &dentry->d_parent->d_subdirs);
  2155. write_seqcount_end(&target->d_seq);
  2156. write_seqcount_end(&dentry->d_seq);
  2157. dentry_unlock_parents_for_move(dentry, target);
  2158. spin_unlock(&target->d_lock);
  2159. fsnotify_d_move(dentry);
  2160. spin_unlock(&dentry->d_lock);
  2161. }
  2162. /*
  2163. * d_move - move a dentry
  2164. * @dentry: entry to move
  2165. * @target: new dentry
  2166. *
  2167. * Update the dcache to reflect the move of a file name. Negative
  2168. * dcache entries should not be moved in this way. See the locking
  2169. * requirements for __d_move.
  2170. */
  2171. void d_move(struct dentry *dentry, struct dentry *target)
  2172. {
  2173. write_seqlock(&rename_lock);
  2174. __d_move(dentry, target);
  2175. write_sequnlock(&rename_lock);
  2176. }
  2177. EXPORT_SYMBOL(d_move);
  2178. /**
  2179. * d_ancestor - search for an ancestor
  2180. * @p1: ancestor dentry
  2181. * @p2: child dentry
  2182. *
  2183. * Returns the ancestor dentry of p2 which is a child of p1, if p1 is
  2184. * an ancestor of p2, else NULL.
  2185. */
  2186. struct dentry *d_ancestor(struct dentry *p1, struct dentry *p2)
  2187. {
  2188. struct dentry *p;
  2189. for (p = p2; !IS_ROOT(p); p = p->d_parent) {
  2190. if (p->d_parent == p1)
  2191. return p;
  2192. }
  2193. return NULL;
  2194. }
  2195. /*
  2196. * This helper attempts to cope with remotely renamed directories
  2197. *
  2198. * It assumes that the caller is already holding
  2199. * dentry->d_parent->d_inode->i_mutex, inode->i_lock and rename_lock
  2200. *
  2201. * Note: If ever the locking in lock_rename() changes, then please
  2202. * remember to update this too...
  2203. */
  2204. static struct dentry *__d_unalias(struct inode *inode,
  2205. struct dentry *dentry, struct dentry *alias)
  2206. {
  2207. struct mutex *m1 = NULL, *m2 = NULL;
  2208. struct dentry *ret = ERR_PTR(-EBUSY);
  2209. /* If alias and dentry share a parent, then no extra locks required */
  2210. if (alias->d_parent == dentry->d_parent)
  2211. goto out_unalias;
  2212. /* See lock_rename() */
  2213. if (!mutex_trylock(&dentry->d_sb->s_vfs_rename_mutex))
  2214. goto out_err;
  2215. m1 = &dentry->d_sb->s_vfs_rename_mutex;
  2216. if (!mutex_trylock(&alias->d_parent->d_inode->i_mutex))
  2217. goto out_err;
  2218. m2 = &alias->d_parent->d_inode->i_mutex;
  2219. out_unalias:
  2220. if (likely(!d_mountpoint(alias))) {
  2221. __d_move(alias, dentry);
  2222. ret = alias;
  2223. }
  2224. out_err:
  2225. spin_unlock(&inode->i_lock);
  2226. if (m2)
  2227. mutex_unlock(m2);
  2228. if (m1)
  2229. mutex_unlock(m1);
  2230. return ret;
  2231. }
  2232. /*
  2233. * Prepare an anonymous dentry for life in the superblock's dentry tree as a
  2234. * named dentry in place of the dentry to be replaced.
  2235. * returns with anon->d_lock held!
  2236. */
  2237. static void __d_materialise_dentry(struct dentry *dentry, struct dentry *anon)
  2238. {
  2239. struct dentry *dparent;
  2240. dentry_lock_for_move(anon, dentry);
  2241. write_seqcount_begin(&dentry->d_seq);
  2242. write_seqcount_begin(&anon->d_seq);
  2243. dparent = dentry->d_parent;
  2244. switch_names(dentry, anon);
  2245. swap(dentry->d_name.hash, anon->d_name.hash);
  2246. dentry->d_parent = dentry;
  2247. list_del_init(&dentry->d_u.d_child);
  2248. anon->d_parent = dparent;
  2249. list_move(&anon->d_u.d_child, &dparent->d_subdirs);
  2250. write_seqcount_end(&dentry->d_seq);
  2251. write_seqcount_end(&anon->d_seq);
  2252. dentry_unlock_parents_for_move(anon, dentry);
  2253. spin_unlock(&dentry->d_lock);
  2254. /* anon->d_lock still locked, returns locked */
  2255. anon->d_flags &= ~DCACHE_DISCONNECTED;
  2256. }
  2257. /**
  2258. * d_materialise_unique - introduce an inode into the tree
  2259. * @dentry: candidate dentry
  2260. * @inode: inode to bind to the dentry, to which aliases may be attached
  2261. *
  2262. * Introduces an dentry into the tree, substituting an extant disconnected
  2263. * root directory alias in its place if there is one. Caller must hold the
  2264. * i_mutex of the parent directory.
  2265. */
  2266. struct dentry *d_materialise_unique(struct dentry *dentry, struct inode *inode)
  2267. {
  2268. struct dentry *actual;
  2269. BUG_ON(!d_unhashed(dentry));
  2270. if (!inode) {
  2271. actual = dentry;
  2272. __d_instantiate(dentry, NULL);
  2273. d_rehash(actual);
  2274. goto out_nolock;
  2275. }
  2276. spin_lock(&inode->i_lock);
  2277. if (S_ISDIR(inode->i_mode)) {
  2278. struct dentry *alias;
  2279. /* Does an aliased dentry already exist? */
  2280. alias = __d_find_alias(inode, 0);
  2281. if (alias) {
  2282. actual = alias;
  2283. write_seqlock(&rename_lock);
  2284. if (d_ancestor(alias, dentry)) {
  2285. /* Check for loops */
  2286. actual = ERR_PTR(-ELOOP);
  2287. spin_unlock(&inode->i_lock);
  2288. } else if (IS_ROOT(alias)) {
  2289. /* Is this an anonymous mountpoint that we
  2290. * could splice into our tree? */
  2291. __d_materialise_dentry(dentry, alias);
  2292. write_sequnlock(&rename_lock);
  2293. __d_drop(alias);
  2294. goto found;
  2295. } else {
  2296. /* Nope, but we must(!) avoid directory
  2297. * aliasing. This drops inode->i_lock */
  2298. actual = __d_unalias(inode, dentry, alias);
  2299. }
  2300. write_sequnlock(&rename_lock);
  2301. if (IS_ERR(actual)) {
  2302. if (PTR_ERR(actual) == -ELOOP)
  2303. pr_warn_ratelimited(
  2304. "VFS: Lookup of '%s' in %s %s"
  2305. " would have caused loop\n",
  2306. dentry->d_name.name,
  2307. inode->i_sb->s_type->name,
  2308. inode->i_sb->s_id);
  2309. dput(alias);
  2310. }
  2311. goto out_nolock;
  2312. }
  2313. }
  2314. /* Add a unique reference */
  2315. actual = __d_instantiate_unique(dentry, inode);
  2316. if (!actual)
  2317. actual = dentry;
  2318. else
  2319. BUG_ON(!d_unhashed(actual));
  2320. spin_lock(&actual->d_lock);
  2321. found:
  2322. _d_rehash(actual);
  2323. spin_unlock(&actual->d_lock);
  2324. spin_unlock(&inode->i_lock);
  2325. out_nolock:
  2326. if (actual == dentry) {
  2327. security_d_instantiate(dentry, inode);
  2328. return NULL;
  2329. }
  2330. iput(inode);
  2331. return actual;
  2332. }
  2333. EXPORT_SYMBOL_GPL(d_materialise_unique);
  2334. static int prepend(char **buffer, int *buflen, const char *str, int namelen)
  2335. {
  2336. *buflen -= namelen;
  2337. if (*buflen < 0)
  2338. return -ENAMETOOLONG;
  2339. *buffer -= namelen;
  2340. memcpy(*buffer, str, namelen);
  2341. return 0;
  2342. }
  2343. static int prepend_name(char **buffer, int *buflen, struct qstr *name)
  2344. {
  2345. return prepend(buffer, buflen, name->name, name->len);
  2346. }
  2347. /**
  2348. * prepend_path - Prepend path string to a buffer
  2349. * @path: the dentry/vfsmount to report
  2350. * @root: root vfsmnt/dentry
  2351. * @buffer: pointer to the end of the buffer
  2352. * @buflen: pointer to buffer length
  2353. *
  2354. * Caller holds the rename_lock.
  2355. */
  2356. static int prepend_path(const struct path *path,
  2357. const struct path *root,
  2358. char **buffer, int *buflen)
  2359. {
  2360. struct dentry *dentry = path->dentry;
  2361. struct vfsmount *vfsmnt = path->mnt;
  2362. struct mount *mnt = real_mount(vfsmnt);
  2363. bool slash = false;
  2364. int error = 0;
  2365. while (dentry != root->dentry || vfsmnt != root->mnt) {
  2366. struct dentry * parent;
  2367. if (dentry == vfsmnt->mnt_root || IS_ROOT(dentry)) {
  2368. /* Global root? */
  2369. if (!mnt_has_parent(mnt))
  2370. goto global_root;
  2371. dentry = mnt->mnt_mountpoint;
  2372. mnt = mnt->mnt_parent;
  2373. vfsmnt = &mnt->mnt;
  2374. continue;
  2375. }
  2376. parent = dentry->d_parent;
  2377. prefetch(parent);
  2378. spin_lock(&dentry->d_lock);
  2379. error = prepend_name(buffer, buflen, &dentry->d_name);
  2380. spin_unlock(&dentry->d_lock);
  2381. if (!error)
  2382. error = prepend(buffer, buflen, "/", 1);
  2383. if (error)
  2384. break;
  2385. slash = true;
  2386. dentry = parent;
  2387. }
  2388. if (!error && !slash)
  2389. error = prepend(buffer, buflen, "/", 1);
  2390. return error;
  2391. global_root:
  2392. /*
  2393. * Filesystems needing to implement special "root names"
  2394. * should do so with ->d_dname()
  2395. */
  2396. if (IS_ROOT(dentry) &&
  2397. (dentry->d_name.len != 1 || dentry->d_name.name[0] != '/')) {
  2398. WARN(1, "Root dentry has weird name <%.*s>\n",
  2399. (int) dentry->d_name.len, dentry->d_name.name);
  2400. }
  2401. if (!slash)
  2402. error = prepend(buffer, buflen, "/", 1);
  2403. if (!error)
  2404. error = is_mounted(vfsmnt) ? 1 : 2;
  2405. return error;
  2406. }
  2407. /**
  2408. * __d_path - return the path of a dentry
  2409. * @path: the dentry/vfsmount to report
  2410. * @root: root vfsmnt/dentry
  2411. * @buf: buffer to return value in
  2412. * @buflen: buffer length
  2413. *
  2414. * Convert a dentry into an ASCII path name.
  2415. *
  2416. * Returns a pointer into the buffer or an error code if the
  2417. * path was too long.
  2418. *
  2419. * "buflen" should be positive.
  2420. *
  2421. * If the path is not reachable from the supplied root, return %NULL.
  2422. */
  2423. char *__d_path(const struct path *path,
  2424. const struct path *root,
  2425. char *buf, int buflen)
  2426. {
  2427. char *res = buf + buflen;
  2428. int error;
  2429. prepend(&res, &buflen, "\0", 1);
  2430. br_read_lock(&vfsmount_lock);
  2431. write_seqlock(&rename_lock);
  2432. error = prepend_path(path, root, &res, &buflen);
  2433. write_sequnlock(&rename_lock);
  2434. br_read_unlock(&vfsmount_lock);
  2435. if (error < 0)
  2436. return ERR_PTR(error);
  2437. if (error > 0)
  2438. return NULL;
  2439. return res;
  2440. }
  2441. char *d_absolute_path(const struct path *path,
  2442. char *buf, int buflen)
  2443. {
  2444. struct path root = {};
  2445. char *res = buf + buflen;
  2446. int error;
  2447. prepend(&res, &buflen, "\0", 1);
  2448. br_read_lock(&vfsmount_lock);
  2449. write_seqlock(&rename_lock);
  2450. error = prepend_path(path, &root, &res, &buflen);
  2451. write_sequnlock(&rename_lock);
  2452. br_read_unlock(&vfsmount_lock);
  2453. if (error > 1)
  2454. error = -EINVAL;
  2455. if (error < 0)
  2456. return ERR_PTR(error);
  2457. return res;
  2458. }
  2459. /*
  2460. * same as __d_path but appends "(deleted)" for unlinked files.
  2461. */
  2462. static int path_with_deleted(const struct path *path,
  2463. const struct path *root,
  2464. char **buf, int *buflen)
  2465. {
  2466. prepend(buf, buflen, "\0", 1);
  2467. if (d_unlinked(path->dentry)) {
  2468. int error = prepend(buf, buflen, " (deleted)", 10);
  2469. if (error)
  2470. return error;
  2471. }
  2472. return prepend_path(path, root, buf, buflen);
  2473. }
  2474. static int prepend_unreachable(char **buffer, int *buflen)
  2475. {
  2476. return prepend(buffer, buflen, "(unreachable)", 13);
  2477. }
  2478. /**
  2479. * d_path - return the path of a dentry
  2480. * @path: path to report
  2481. * @buf: buffer to return value in
  2482. * @buflen: buffer length
  2483. *
  2484. * Convert a dentry into an ASCII path name. If the entry has been deleted
  2485. * the string " (deleted)" is appended. Note that this is ambiguous.
  2486. *
  2487. * Returns a pointer into the buffer or an error code if the path was
  2488. * too long. Note: Callers should use the returned pointer, not the passed
  2489. * in buffer, to use the name! The implementation often starts at an offset
  2490. * into the buffer, and may leave 0 bytes at the start.
  2491. *
  2492. * "buflen" should be positive.
  2493. */
  2494. char *d_path(const struct path *path, char *buf, int buflen)
  2495. {
  2496. char *res = buf + buflen;
  2497. struct path root;
  2498. int error;
  2499. /*
  2500. * We have various synthetic filesystems that never get mounted. On
  2501. * these filesystems dentries are never used for lookup purposes, and
  2502. * thus don't need to be hashed. They also don't need a name until a
  2503. * user wants to identify the object in /proc/pid/fd/. The little hack
  2504. * below allows us to generate a name for these objects on demand:
  2505. */
  2506. if (path->dentry->d_op && path->dentry->d_op->d_dname)
  2507. return path->dentry->d_op->d_dname(path->dentry, buf, buflen);
  2508. get_fs_root(current->fs, &root);
  2509. br_read_lock(&vfsmount_lock);
  2510. write_seqlock(&rename_lock);
  2511. error = path_with_deleted(path, &root, &res, &buflen);
  2512. write_sequnlock(&rename_lock);
  2513. br_read_unlock(&vfsmount_lock);
  2514. if (error < 0)
  2515. res = ERR_PTR(error);
  2516. path_put(&root);
  2517. return res;
  2518. }
  2519. EXPORT_SYMBOL(d_path);
  2520. /*
  2521. * Helper function for dentry_operations.d_dname() members
  2522. */
  2523. char *dynamic_dname(struct dentry *dentry, char *buffer, int buflen,
  2524. const char *fmt, ...)
  2525. {
  2526. va_list args;
  2527. char temp[64];
  2528. int sz;
  2529. va_start(args, fmt);
  2530. sz = vsnprintf(temp, sizeof(temp), fmt, args) + 1;
  2531. va_end(args);
  2532. if (sz > sizeof(temp) || sz > buflen)
  2533. return ERR_PTR(-ENAMETOOLONG);
  2534. buffer += buflen - sz;
  2535. return memcpy(buffer, temp, sz);
  2536. }
  2537. char *simple_dname(struct dentry *dentry, char *buffer, int buflen)
  2538. {
  2539. char *end = buffer + buflen;
  2540. /* these dentries are never renamed, so d_lock is not needed */
  2541. if (prepend(&end, &buflen, " (deleted)", 11) ||
  2542. prepend_name(&end, &buflen, &dentry->d_name) ||
  2543. prepend(&end, &buflen, "/", 1))
  2544. end = ERR_PTR(-ENAMETOOLONG);
  2545. return end;
  2546. }
  2547. /*
  2548. * Write full pathname from the root of the filesystem into the buffer.
  2549. */
  2550. static char *__dentry_path(struct dentry *dentry, char *buf, int buflen)
  2551. {
  2552. char *end = buf + buflen;
  2553. char *retval;
  2554. prepend(&end, &buflen, "\0", 1);
  2555. if (buflen < 1)
  2556. goto Elong;
  2557. /* Get '/' right */
  2558. retval = end-1;
  2559. *retval = '/';
  2560. while (!IS_ROOT(dentry)) {
  2561. struct dentry *parent = dentry->d_parent;
  2562. int error;
  2563. prefetch(parent);
  2564. spin_lock(&dentry->d_lock);
  2565. error = prepend_name(&end, &buflen, &dentry->d_name);
  2566. spin_unlock(&dentry->d_lock);
  2567. if (error != 0 || prepend(&end, &buflen, "/", 1) != 0)
  2568. goto Elong;
  2569. retval = end;
  2570. dentry = parent;
  2571. }
  2572. return retval;
  2573. Elong:
  2574. return ERR_PTR(-ENAMETOOLONG);
  2575. }
  2576. char *dentry_path_raw(struct dentry *dentry, char *buf, int buflen)
  2577. {
  2578. char *retval;
  2579. write_seqlock(&rename_lock);
  2580. retval = __dentry_path(dentry, buf, buflen);
  2581. write_sequnlock(&rename_lock);
  2582. return retval;
  2583. }
  2584. EXPORT_SYMBOL(dentry_path_raw);
  2585. char *dentry_path(struct dentry *dentry, char *buf, int buflen)
  2586. {
  2587. char *p = NULL;
  2588. char *retval;
  2589. write_seqlock(&rename_lock);
  2590. if (d_unlinked(dentry)) {
  2591. p = buf + buflen;
  2592. if (prepend(&p, &buflen, "//deleted", 10) != 0)
  2593. goto Elong;
  2594. buflen++;
  2595. }
  2596. retval = __dentry_path(dentry, buf, buflen);
  2597. write_sequnlock(&rename_lock);
  2598. if (!IS_ERR(retval) && p)
  2599. *p = '/'; /* restore '/' overriden with '\0' */
  2600. return retval;
  2601. Elong:
  2602. return ERR_PTR(-ENAMETOOLONG);
  2603. }
  2604. /*
  2605. * NOTE! The user-level library version returns a
  2606. * character pointer. The kernel system call just
  2607. * returns the length of the buffer filled (which
  2608. * includes the ending '\0' character), or a negative
  2609. * error value. So libc would do something like
  2610. *
  2611. * char *getcwd(char * buf, size_t size)
  2612. * {
  2613. * int retval;
  2614. *
  2615. * retval = sys_getcwd(buf, size);
  2616. * if (retval >= 0)
  2617. * return buf;
  2618. * errno = -retval;
  2619. * return NULL;
  2620. * }
  2621. */
  2622. SYSCALL_DEFINE2(getcwd, char __user *, buf, unsigned long, size)
  2623. {
  2624. int error;
  2625. struct path pwd, root;
  2626. char *page = (char *) __get_free_page(GFP_USER);
  2627. if (!page)
  2628. return -ENOMEM;
  2629. get_fs_root_and_pwd(current->fs, &root, &pwd);
  2630. error = -ENOENT;
  2631. br_read_lock(&vfsmount_lock);
  2632. write_seqlock(&rename_lock);
  2633. if (!d_unlinked(pwd.dentry)) {
  2634. unsigned long len;
  2635. char *cwd = page + PAGE_SIZE;
  2636. int buflen = PAGE_SIZE;
  2637. prepend(&cwd, &buflen, "\0", 1);
  2638. error = prepend_path(&pwd, &root, &cwd, &buflen);
  2639. write_sequnlock(&rename_lock);
  2640. br_read_unlock(&vfsmount_lock);
  2641. if (error < 0)
  2642. goto out;
  2643. /* Unreachable from current root */
  2644. if (error > 0) {
  2645. error = prepend_unreachable(&cwd, &buflen);
  2646. if (error)
  2647. goto out;
  2648. }
  2649. error = -ERANGE;
  2650. len = PAGE_SIZE + page - cwd;
  2651. if (len <= size) {
  2652. error = len;
  2653. if (copy_to_user(buf, cwd, len))
  2654. error = -EFAULT;
  2655. }
  2656. } else {
  2657. write_sequnlock(&rename_lock);
  2658. br_read_unlock(&vfsmount_lock);
  2659. }
  2660. out:
  2661. path_put(&pwd);
  2662. path_put(&root);
  2663. free_page((unsigned long) page);
  2664. return error;
  2665. }
  2666. /*
  2667. * Test whether new_dentry is a subdirectory of old_dentry.
  2668. *
  2669. * Trivially implemented using the dcache structure
  2670. */
  2671. /**
  2672. * is_subdir - is new dentry a subdirectory of old_dentry
  2673. * @new_dentry: new dentry
  2674. * @old_dentry: old dentry
  2675. *
  2676. * Returns 1 if new_dentry is a subdirectory of the parent (at any depth).
  2677. * Returns 0 otherwise.
  2678. * Caller must ensure that "new_dentry" is pinned before calling is_subdir()
  2679. */
  2680. int is_subdir(struct dentry *new_dentry, struct dentry *old_dentry)
  2681. {
  2682. int result;
  2683. unsigned seq;
  2684. if (new_dentry == old_dentry)
  2685. return 1;
  2686. do {
  2687. /* for restarting inner loop in case of seq retry */
  2688. seq = read_seqbegin(&rename_lock);
  2689. /*
  2690. * Need rcu_readlock to protect against the d_parent trashing
  2691. * due to d_move
  2692. */
  2693. rcu_read_lock();
  2694. if (d_ancestor(old_dentry, new_dentry))
  2695. result = 1;
  2696. else
  2697. result = 0;
  2698. rcu_read_unlock();
  2699. } while (read_seqretry(&rename_lock, seq));
  2700. return result;
  2701. }
  2702. static enum d_walk_ret d_genocide_kill(void *data, struct dentry *dentry)
  2703. {
  2704. struct dentry *root = data;
  2705. if (dentry != root) {
  2706. if (d_unhashed(dentry) || !dentry->d_inode)
  2707. return D_WALK_SKIP;
  2708. if (!(dentry->d_flags & DCACHE_GENOCIDE)) {
  2709. dentry->d_flags |= DCACHE_GENOCIDE;
  2710. dentry->d_lockref.count--;
  2711. }
  2712. }
  2713. return D_WALK_CONTINUE;
  2714. }
  2715. void d_genocide(struct dentry *parent)
  2716. {
  2717. d_walk(parent, parent, d_genocide_kill, NULL);
  2718. }
  2719. void d_tmpfile(struct dentry *dentry, struct inode *inode)
  2720. {
  2721. inode_dec_link_count(inode);
  2722. BUG_ON(dentry->d_name.name != dentry->d_iname ||
  2723. !hlist_unhashed(&dentry->d_alias) ||
  2724. !d_unlinked(dentry));
  2725. spin_lock(&dentry->d_parent->d_lock);
  2726. spin_lock_nested(&dentry->d_lock, DENTRY_D_LOCK_NESTED);
  2727. dentry->d_name.len = sprintf(dentry->d_iname, "#%llu",
  2728. (unsigned long long)inode->i_ino);
  2729. spin_unlock(&dentry->d_lock);
  2730. spin_unlock(&dentry->d_parent->d_lock);
  2731. d_instantiate(dentry, inode);
  2732. }
  2733. EXPORT_SYMBOL(d_tmpfile);
  2734. static __initdata unsigned long dhash_entries;
  2735. static int __init set_dhash_entries(char *str)
  2736. {
  2737. if (!str)
  2738. return 0;
  2739. dhash_entries = simple_strtoul(str, &str, 0);
  2740. return 1;
  2741. }
  2742. __setup("dhash_entries=", set_dhash_entries);
  2743. static void __init dcache_init_early(void)
  2744. {
  2745. unsigned int loop;
  2746. /* If hashes are distributed across NUMA nodes, defer
  2747. * hash allocation until vmalloc space is available.
  2748. */
  2749. if (hashdist)
  2750. return;
  2751. dentry_hashtable =
  2752. alloc_large_system_hash("Dentry cache",
  2753. sizeof(struct hlist_bl_head),
  2754. dhash_entries,
  2755. 13,
  2756. HASH_EARLY,
  2757. &d_hash_shift,
  2758. &d_hash_mask,
  2759. 0,
  2760. 0);
  2761. for (loop = 0; loop < (1U << d_hash_shift); loop++)
  2762. INIT_HLIST_BL_HEAD(dentry_hashtable + loop);
  2763. }
  2764. static void __init dcache_init(void)
  2765. {
  2766. unsigned int loop;
  2767. /*
  2768. * A constructor could be added for stable state like the lists,
  2769. * but it is probably not worth it because of the cache nature
  2770. * of the dcache.
  2771. */
  2772. dentry_cache = KMEM_CACHE(dentry,
  2773. SLAB_RECLAIM_ACCOUNT|SLAB_PANIC|SLAB_MEM_SPREAD);
  2774. /* Hash may have been set up in dcache_init_early */
  2775. if (!hashdist)
  2776. return;
  2777. dentry_hashtable =
  2778. alloc_large_system_hash("Dentry cache",
  2779. sizeof(struct hlist_bl_head),
  2780. dhash_entries,
  2781. 13,
  2782. 0,
  2783. &d_hash_shift,
  2784. &d_hash_mask,
  2785. 0,
  2786. 0);
  2787. for (loop = 0; loop < (1U << d_hash_shift); loop++)
  2788. INIT_HLIST_BL_HEAD(dentry_hashtable + loop);
  2789. }
  2790. /* SLAB cache for __getname() consumers */
  2791. struct kmem_cache *names_cachep __read_mostly;
  2792. EXPORT_SYMBOL(names_cachep);
  2793. EXPORT_SYMBOL(d_genocide);
  2794. void __init vfs_caches_init_early(void)
  2795. {
  2796. dcache_init_early();
  2797. inode_init_early();
  2798. }
  2799. void __init vfs_caches_init(unsigned long mempages)
  2800. {
  2801. unsigned long reserve;
  2802. /* Base hash sizes on available memory, with a reserve equal to
  2803. 150% of current kernel size */
  2804. reserve = min((mempages - nr_free_pages()) * 3/2, mempages - 1);
  2805. mempages -= reserve;
  2806. names_cachep = kmem_cache_create("names_cache", PATH_MAX, 0,
  2807. SLAB_HWCACHE_ALIGN|SLAB_PANIC, NULL);
  2808. dcache_init();
  2809. inode_init();
  2810. files_init(mempages);
  2811. mnt_init();
  2812. bdev_cache_init();
  2813. chrdev_init();
  2814. }