]>
Commit | Line | Data |
---|---|---|
1da177e4 LT |
1 | /* |
2 | * hugetlbpage-backed filesystem. Based on ramfs. | |
3 | * | |
4 | * William Irwin, 2002 | |
5 | * | |
6 | * Copyright (C) 2002 Linus Torvalds. | |
7 | */ | |
8 | ||
9 | #include <linux/module.h> | |
10 | #include <linux/thread_info.h> | |
11 | #include <asm/current.h> | |
12 | #include <linux/sched.h> /* remove ASAP */ | |
13 | #include <linux/fs.h> | |
14 | #include <linux/mount.h> | |
15 | #include <linux/file.h> | |
e73a75fa | 16 | #include <linux/kernel.h> |
1da177e4 LT |
17 | #include <linux/writeback.h> |
18 | #include <linux/pagemap.h> | |
19 | #include <linux/highmem.h> | |
20 | #include <linux/init.h> | |
21 | #include <linux/string.h> | |
16f7e0fe | 22 | #include <linux/capability.h> |
e73a75fa | 23 | #include <linux/ctype.h> |
1da177e4 LT |
24 | #include <linux/backing-dev.h> |
25 | #include <linux/hugetlb.h> | |
26 | #include <linux/pagevec.h> | |
e73a75fa | 27 | #include <linux/parser.h> |
036e0856 | 28 | #include <linux/mman.h> |
1da177e4 LT |
29 | #include <linux/quotaops.h> |
30 | #include <linux/slab.h> | |
31 | #include <linux/dnotify.h> | |
32 | #include <linux/statfs.h> | |
33 | #include <linux/security.h> | |
34 | ||
35 | #include <asm/uaccess.h> | |
36 | ||
37 | /* some random number */ | |
38 | #define HUGETLBFS_MAGIC 0x958458f6 | |
39 | ||
ee9b6d61 | 40 | static const struct super_operations hugetlbfs_ops; |
f5e54d6e | 41 | static const struct address_space_operations hugetlbfs_aops; |
4b6f5d20 | 42 | const struct file_operations hugetlbfs_file_operations; |
92e1d5be AV |
43 | static const struct inode_operations hugetlbfs_dir_inode_operations; |
44 | static const struct inode_operations hugetlbfs_inode_operations; | |
1da177e4 LT |
45 | |
46 | static struct backing_dev_info hugetlbfs_backing_dev_info = { | |
47 | .ra_pages = 0, /* No readahead */ | |
e4ad08fe | 48 | .capabilities = BDI_CAP_NO_ACCT_AND_WRITEBACK, |
1da177e4 LT |
49 | }; |
50 | ||
51 | int sysctl_hugetlb_shm_group; | |
52 | ||
e73a75fa RD |
53 | enum { |
54 | Opt_size, Opt_nr_inodes, | |
55 | Opt_mode, Opt_uid, Opt_gid, | |
a137e1cc | 56 | Opt_pagesize, |
e73a75fa RD |
57 | Opt_err, |
58 | }; | |
59 | ||
a447c093 | 60 | static const match_table_t tokens = { |
e73a75fa RD |
61 | {Opt_size, "size=%s"}, |
62 | {Opt_nr_inodes, "nr_inodes=%s"}, | |
63 | {Opt_mode, "mode=%o"}, | |
64 | {Opt_uid, "uid=%u"}, | |
65 | {Opt_gid, "gid=%u"}, | |
a137e1cc | 66 | {Opt_pagesize, "pagesize=%s"}, |
e73a75fa RD |
67 | {Opt_err, NULL}, |
68 | }; | |
69 | ||
2e9b367c AL |
70 | static void huge_pagevec_release(struct pagevec *pvec) |
71 | { | |
72 | int i; | |
73 | ||
74 | for (i = 0; i < pagevec_count(pvec); ++i) | |
75 | put_page(pvec->pages[i]); | |
76 | ||
77 | pagevec_reinit(pvec); | |
78 | } | |
79 | ||
1da177e4 LT |
80 | static int hugetlbfs_file_mmap(struct file *file, struct vm_area_struct *vma) |
81 | { | |
b39424e2 | 82 | struct inode *inode = file->f_path.dentry->d_inode; |
1da177e4 LT |
83 | loff_t len, vma_len; |
84 | int ret; | |
a5516438 | 85 | struct hstate *h = hstate_file(file); |
1da177e4 | 86 | |
68589bc3 | 87 | /* |
dec4ad86 DG |
88 | * vma address alignment (but not the pgoff alignment) has |
89 | * already been checked by prepare_hugepage_range. If you add | |
90 | * any error returns here, do so after setting VM_HUGETLB, so | |
91 | * is_vm_hugetlb_page tests below unmap_region go the right | |
92 | * way when do_mmap_pgoff unwinds (may be important on powerpc | |
93 | * and ia64). | |
68589bc3 HD |
94 | */ |
95 | vma->vm_flags |= VM_HUGETLB | VM_RESERVED; | |
96 | vma->vm_ops = &hugetlb_vm_ops; | |
1da177e4 | 97 | |
a5516438 | 98 | if (vma->vm_pgoff & ~(huge_page_mask(h) >> PAGE_SHIFT)) |
dec4ad86 DG |
99 | return -EINVAL; |
100 | ||
1da177e4 LT |
101 | vma_len = (loff_t)(vma->vm_end - vma->vm_start); |
102 | ||
1b1dcc1b | 103 | mutex_lock(&inode->i_mutex); |
1da177e4 | 104 | file_accessed(file); |
1da177e4 LT |
105 | |
106 | ret = -ENOMEM; | |
107 | len = vma_len + ((loff_t)vma->vm_pgoff << PAGE_SHIFT); | |
1da177e4 | 108 | |
a1e78772 | 109 | if (hugetlb_reserve_pages(inode, |
a5516438 AK |
110 | vma->vm_pgoff >> huge_page_order(h), |
111 | len >> huge_page_shift(h), vma)) | |
a43a8c39 | 112 | goto out; |
b45b5bd6 | 113 | |
4c887265 AL |
114 | ret = 0; |
115 | hugetlb_prefault_arch_hook(vma->vm_mm); | |
b6174df5 | 116 | if (vma->vm_flags & VM_WRITE && inode->i_size < len) |
1da177e4 LT |
117 | inode->i_size = len; |
118 | out: | |
1b1dcc1b | 119 | mutex_unlock(&inode->i_mutex); |
1da177e4 LT |
120 | |
121 | return ret; | |
122 | } | |
123 | ||
124 | /* | |
508034a3 | 125 | * Called under down_write(mmap_sem). |
1da177e4 LT |
126 | */ |
127 | ||
d2ba27e8 | 128 | #ifndef HAVE_ARCH_HUGETLB_UNMAPPED_AREA |
1da177e4 LT |
129 | static unsigned long |
130 | hugetlb_get_unmapped_area(struct file *file, unsigned long addr, | |
131 | unsigned long len, unsigned long pgoff, unsigned long flags) | |
132 | { | |
133 | struct mm_struct *mm = current->mm; | |
134 | struct vm_area_struct *vma; | |
135 | unsigned long start_addr; | |
a5516438 | 136 | struct hstate *h = hstate_file(file); |
1da177e4 | 137 | |
a5516438 | 138 | if (len & ~huge_page_mask(h)) |
1da177e4 LT |
139 | return -EINVAL; |
140 | if (len > TASK_SIZE) | |
141 | return -ENOMEM; | |
142 | ||
036e0856 | 143 | if (flags & MAP_FIXED) { |
a5516438 | 144 | if (prepare_hugepage_range(file, addr, len)) |
036e0856 BH |
145 | return -EINVAL; |
146 | return addr; | |
147 | } | |
148 | ||
1da177e4 | 149 | if (addr) { |
a5516438 | 150 | addr = ALIGN(addr, huge_page_size(h)); |
1da177e4 LT |
151 | vma = find_vma(mm, addr); |
152 | if (TASK_SIZE - len >= addr && | |
153 | (!vma || addr + len <= vma->vm_start)) | |
154 | return addr; | |
155 | } | |
156 | ||
157 | start_addr = mm->free_area_cache; | |
158 | ||
1363c3cd WW |
159 | if (len <= mm->cached_hole_size) |
160 | start_addr = TASK_UNMAPPED_BASE; | |
161 | ||
1da177e4 | 162 | full_search: |
a5516438 | 163 | addr = ALIGN(start_addr, huge_page_size(h)); |
1da177e4 LT |
164 | |
165 | for (vma = find_vma(mm, addr); ; vma = vma->vm_next) { | |
166 | /* At this point: (!vma || addr < vma->vm_end). */ | |
167 | if (TASK_SIZE - len < addr) { | |
168 | /* | |
169 | * Start a new search - just in case we missed | |
170 | * some holes. | |
171 | */ | |
172 | if (start_addr != TASK_UNMAPPED_BASE) { | |
173 | start_addr = TASK_UNMAPPED_BASE; | |
174 | goto full_search; | |
175 | } | |
176 | return -ENOMEM; | |
177 | } | |
178 | ||
179 | if (!vma || addr + len <= vma->vm_start) | |
180 | return addr; | |
a5516438 | 181 | addr = ALIGN(vma->vm_end, huge_page_size(h)); |
1da177e4 LT |
182 | } |
183 | } | |
184 | #endif | |
185 | ||
e63e1e5a BP |
186 | static int |
187 | hugetlbfs_read_actor(struct page *page, unsigned long offset, | |
188 | char __user *buf, unsigned long count, | |
189 | unsigned long size) | |
190 | { | |
191 | char *kaddr; | |
192 | unsigned long left, copied = 0; | |
193 | int i, chunksize; | |
194 | ||
195 | if (size > count) | |
196 | size = count; | |
197 | ||
198 | /* Find which 4k chunk and offset with in that chunk */ | |
199 | i = offset >> PAGE_CACHE_SHIFT; | |
200 | offset = offset & ~PAGE_CACHE_MASK; | |
201 | ||
202 | while (size) { | |
203 | chunksize = PAGE_CACHE_SIZE; | |
204 | if (offset) | |
205 | chunksize -= offset; | |
206 | if (chunksize > size) | |
207 | chunksize = size; | |
208 | kaddr = kmap(&page[i]); | |
209 | left = __copy_to_user(buf, kaddr + offset, chunksize); | |
210 | kunmap(&page[i]); | |
211 | if (left) { | |
212 | copied += (chunksize - left); | |
213 | break; | |
214 | } | |
215 | offset = 0; | |
216 | size -= chunksize; | |
217 | buf += chunksize; | |
218 | copied += chunksize; | |
219 | i++; | |
220 | } | |
221 | return copied ? copied : -EFAULT; | |
222 | } | |
223 | ||
224 | /* | |
225 | * Support for read() - Find the page attached to f_mapping and copy out the | |
226 | * data. Its *very* similar to do_generic_mapping_read(), we can't use that | |
227 | * since it has PAGE_CACHE_SIZE assumptions. | |
228 | */ | |
229 | static ssize_t hugetlbfs_read(struct file *filp, char __user *buf, | |
230 | size_t len, loff_t *ppos) | |
231 | { | |
a5516438 | 232 | struct hstate *h = hstate_file(filp); |
e63e1e5a BP |
233 | struct address_space *mapping = filp->f_mapping; |
234 | struct inode *inode = mapping->host; | |
a5516438 AK |
235 | unsigned long index = *ppos >> huge_page_shift(h); |
236 | unsigned long offset = *ppos & ~huge_page_mask(h); | |
e63e1e5a BP |
237 | unsigned long end_index; |
238 | loff_t isize; | |
239 | ssize_t retval = 0; | |
240 | ||
241 | mutex_lock(&inode->i_mutex); | |
242 | ||
243 | /* validate length */ | |
244 | if (len == 0) | |
245 | goto out; | |
246 | ||
247 | isize = i_size_read(inode); | |
248 | if (!isize) | |
249 | goto out; | |
250 | ||
a5516438 | 251 | end_index = (isize - 1) >> huge_page_shift(h); |
e63e1e5a BP |
252 | for (;;) { |
253 | struct page *page; | |
a5516438 | 254 | unsigned long nr, ret; |
91bf189c | 255 | int ra; |
e63e1e5a BP |
256 | |
257 | /* nr is the maximum number of bytes to copy from this page */ | |
a5516438 | 258 | nr = huge_page_size(h); |
e63e1e5a BP |
259 | if (index >= end_index) { |
260 | if (index > end_index) | |
261 | goto out; | |
a5516438 | 262 | nr = ((isize - 1) & ~huge_page_mask(h)) + 1; |
e63e1e5a BP |
263 | if (nr <= offset) { |
264 | goto out; | |
265 | } | |
266 | } | |
267 | nr = nr - offset; | |
268 | ||
269 | /* Find the page */ | |
270 | page = find_get_page(mapping, index); | |
271 | if (unlikely(page == NULL)) { | |
272 | /* | |
273 | * We have a HOLE, zero out the user-buffer for the | |
274 | * length of the hole or request. | |
275 | */ | |
276 | ret = len < nr ? len : nr; | |
277 | if (clear_user(buf, ret)) | |
91bf189c RK |
278 | ra = -EFAULT; |
279 | else | |
280 | ra = 0; | |
e63e1e5a BP |
281 | } else { |
282 | /* | |
283 | * We have the page, copy it to user space buffer. | |
284 | */ | |
91bf189c RK |
285 | ra = hugetlbfs_read_actor(page, offset, buf, len, nr); |
286 | ret = ra; | |
e63e1e5a | 287 | } |
91bf189c | 288 | if (ra < 0) { |
e63e1e5a | 289 | if (retval == 0) |
91bf189c | 290 | retval = ra; |
e63e1e5a BP |
291 | if (page) |
292 | page_cache_release(page); | |
293 | goto out; | |
294 | } | |
295 | ||
296 | offset += ret; | |
297 | retval += ret; | |
298 | len -= ret; | |
a5516438 AK |
299 | index += offset >> huge_page_shift(h); |
300 | offset &= ~huge_page_mask(h); | |
e63e1e5a BP |
301 | |
302 | if (page) | |
303 | page_cache_release(page); | |
304 | ||
305 | /* short read or no more work */ | |
306 | if ((ret != nr) || (len == 0)) | |
307 | break; | |
308 | } | |
309 | out: | |
a5516438 | 310 | *ppos = ((loff_t)index << huge_page_shift(h)) + offset; |
e63e1e5a BP |
311 | mutex_unlock(&inode->i_mutex); |
312 | return retval; | |
313 | } | |
314 | ||
1da177e4 LT |
315 | /* |
316 | * Read a page. Again trivial. If it didn't already exist | |
317 | * in the page cache, it is zero-filled. | |
318 | */ | |
319 | static int hugetlbfs_readpage(struct file *file, struct page * page) | |
320 | { | |
321 | unlock_page(page); | |
322 | return -EINVAL; | |
323 | } | |
324 | ||
800d15a5 NP |
325 | static int hugetlbfs_write_begin(struct file *file, |
326 | struct address_space *mapping, | |
327 | loff_t pos, unsigned len, unsigned flags, | |
328 | struct page **pagep, void **fsdata) | |
1da177e4 LT |
329 | { |
330 | return -EINVAL; | |
331 | } | |
332 | ||
800d15a5 NP |
333 | static int hugetlbfs_write_end(struct file *file, struct address_space *mapping, |
334 | loff_t pos, unsigned len, unsigned copied, | |
335 | struct page *page, void *fsdata) | |
1da177e4 | 336 | { |
800d15a5 | 337 | BUG(); |
1da177e4 LT |
338 | return -EINVAL; |
339 | } | |
340 | ||
1da177e4 LT |
341 | static void truncate_huge_page(struct page *page) |
342 | { | |
fba2591b | 343 | cancel_dirty_page(page, /* No IO accounting for huge pages? */0); |
1da177e4 LT |
344 | ClearPageUptodate(page); |
345 | remove_from_page_cache(page); | |
346 | put_page(page); | |
347 | } | |
348 | ||
b45b5bd6 | 349 | static void truncate_hugepages(struct inode *inode, loff_t lstart) |
1da177e4 | 350 | { |
a5516438 | 351 | struct hstate *h = hstate_inode(inode); |
b45b5bd6 | 352 | struct address_space *mapping = &inode->i_data; |
a5516438 | 353 | const pgoff_t start = lstart >> huge_page_shift(h); |
1da177e4 LT |
354 | struct pagevec pvec; |
355 | pgoff_t next; | |
a43a8c39 | 356 | int i, freed = 0; |
1da177e4 LT |
357 | |
358 | pagevec_init(&pvec, 0); | |
359 | next = start; | |
360 | while (1) { | |
361 | if (!pagevec_lookup(&pvec, mapping, next, PAGEVEC_SIZE)) { | |
362 | if (next == start) | |
363 | break; | |
364 | next = start; | |
365 | continue; | |
366 | } | |
367 | ||
368 | for (i = 0; i < pagevec_count(&pvec); ++i) { | |
369 | struct page *page = pvec.pages[i]; | |
370 | ||
371 | lock_page(page); | |
372 | if (page->index > next) | |
373 | next = page->index; | |
374 | ++next; | |
375 | truncate_huge_page(page); | |
376 | unlock_page(page); | |
a43a8c39 | 377 | freed++; |
1da177e4 LT |
378 | } |
379 | huge_pagevec_release(&pvec); | |
380 | } | |
381 | BUG_ON(!lstart && mapping->nrpages); | |
a43a8c39 | 382 | hugetlb_unreserve_pages(inode, start, freed); |
1da177e4 LT |
383 | } |
384 | ||
385 | static void hugetlbfs_delete_inode(struct inode *inode) | |
386 | { | |
b45b5bd6 | 387 | truncate_hugepages(inode, 0); |
149f4211 CH |
388 | clear_inode(inode); |
389 | } | |
390 | ||
ddc0a51d | 391 | static void hugetlbfs_forget_inode(struct inode *inode) __releases(inode_lock) |
1da177e4 | 392 | { |
0b1533f6 CH |
393 | struct super_block *sb = inode->i_sb; |
394 | ||
395 | if (!hlist_unhashed(&inode->i_hash)) { | |
1c0eeaf5 | 396 | if (!(inode->i_state & (I_DIRTY|I_SYNC))) |
0b1533f6 CH |
397 | list_move(&inode->i_list, &inode_unused); |
398 | inodes_stat.nr_unused++; | |
399 | if (!sb || (sb->s_flags & MS_ACTIVE)) { | |
400 | spin_unlock(&inode_lock); | |
401 | return; | |
402 | } | |
403 | inode->i_state |= I_WILL_FREE; | |
1da177e4 | 404 | spin_unlock(&inode_lock); |
0b1533f6 CH |
405 | /* |
406 | * write_inode_now is a noop as we set BDI_CAP_NO_WRITEBACK | |
407 | * in our backing_dev_info. | |
408 | */ | |
409 | write_inode_now(inode, 1); | |
410 | spin_lock(&inode_lock); | |
411 | inode->i_state &= ~I_WILL_FREE; | |
412 | inodes_stat.nr_unused--; | |
413 | hlist_del_init(&inode->i_hash); | |
1da177e4 | 414 | } |
1da177e4 LT |
415 | list_del_init(&inode->i_list); |
416 | list_del_init(&inode->i_sb_list); | |
417 | inode->i_state |= I_FREEING; | |
418 | inodes_stat.nr_inodes--; | |
419 | spin_unlock(&inode_lock); | |
b45b5bd6 | 420 | truncate_hugepages(inode, 0); |
1da177e4 LT |
421 | clear_inode(inode); |
422 | destroy_inode(inode); | |
423 | } | |
424 | ||
425 | static void hugetlbfs_drop_inode(struct inode *inode) | |
426 | { | |
427 | if (!inode->i_nlink) | |
6b09b9df | 428 | generic_delete_inode(inode); |
1da177e4 LT |
429 | else |
430 | hugetlbfs_forget_inode(inode); | |
431 | } | |
432 | ||
1da177e4 | 433 | static inline void |
856fc295 | 434 | hugetlb_vmtruncate_list(struct prio_tree_root *root, pgoff_t pgoff) |
1da177e4 LT |
435 | { |
436 | struct vm_area_struct *vma; | |
437 | struct prio_tree_iter iter; | |
438 | ||
856fc295 | 439 | vma_prio_tree_foreach(vma, &iter, root, pgoff, ULONG_MAX) { |
1da177e4 LT |
440 | unsigned long v_offset; |
441 | ||
1da177e4 | 442 | /* |
856fc295 HD |
443 | * Can the expression below overflow on 32-bit arches? |
444 | * No, because the prio_tree returns us only those vmas | |
445 | * which overlap the truncated area starting at pgoff, | |
446 | * and no vma on a 32-bit arch can span beyond the 4GB. | |
1da177e4 | 447 | */ |
856fc295 HD |
448 | if (vma->vm_pgoff < pgoff) |
449 | v_offset = (pgoff - vma->vm_pgoff) << PAGE_SHIFT; | |
450 | else | |
1da177e4 LT |
451 | v_offset = 0; |
452 | ||
502717f4 | 453 | __unmap_hugepage_range(vma, |
04f2cbe3 | 454 | vma->vm_start + v_offset, vma->vm_end, NULL); |
1da177e4 LT |
455 | } |
456 | } | |
457 | ||
1da177e4 LT |
458 | static int hugetlb_vmtruncate(struct inode *inode, loff_t offset) |
459 | { | |
856fc295 | 460 | pgoff_t pgoff; |
1da177e4 | 461 | struct address_space *mapping = inode->i_mapping; |
a5516438 | 462 | struct hstate *h = hstate_inode(inode); |
1da177e4 | 463 | |
a5516438 | 464 | BUG_ON(offset & ~huge_page_mask(h)); |
856fc295 | 465 | pgoff = offset >> PAGE_SHIFT; |
1da177e4 | 466 | |
7aa91e10 | 467 | i_size_write(inode, offset); |
1da177e4 LT |
468 | spin_lock(&mapping->i_mmap_lock); |
469 | if (!prio_tree_empty(&mapping->i_mmap)) | |
470 | hugetlb_vmtruncate_list(&mapping->i_mmap, pgoff); | |
471 | spin_unlock(&mapping->i_mmap_lock); | |
b45b5bd6 | 472 | truncate_hugepages(inode, offset); |
1da177e4 LT |
473 | return 0; |
474 | } | |
475 | ||
476 | static int hugetlbfs_setattr(struct dentry *dentry, struct iattr *attr) | |
477 | { | |
478 | struct inode *inode = dentry->d_inode; | |
a5516438 | 479 | struct hstate *h = hstate_inode(inode); |
1da177e4 LT |
480 | int error; |
481 | unsigned int ia_valid = attr->ia_valid; | |
482 | ||
483 | BUG_ON(!inode); | |
484 | ||
485 | error = inode_change_ok(inode, attr); | |
486 | if (error) | |
487 | goto out; | |
488 | ||
489 | if (ia_valid & ATTR_SIZE) { | |
490 | error = -EINVAL; | |
a5516438 | 491 | if (!(attr->ia_size & ~huge_page_mask(h))) |
1da177e4 LT |
492 | error = hugetlb_vmtruncate(inode, attr->ia_size); |
493 | if (error) | |
494 | goto out; | |
495 | attr->ia_valid &= ~ATTR_SIZE; | |
496 | } | |
497 | error = inode_setattr(inode, attr); | |
498 | out: | |
499 | return error; | |
500 | } | |
501 | ||
502 | static struct inode *hugetlbfs_get_inode(struct super_block *sb, uid_t uid, | |
503 | gid_t gid, int mode, dev_t dev) | |
504 | { | |
505 | struct inode *inode; | |
1da177e4 LT |
506 | |
507 | inode = new_inode(sb); | |
508 | if (inode) { | |
509 | struct hugetlbfs_inode_info *info; | |
510 | inode->i_mode = mode; | |
511 | inode->i_uid = uid; | |
512 | inode->i_gid = gid; | |
1da177e4 LT |
513 | inode->i_mapping->a_ops = &hugetlbfs_aops; |
514 | inode->i_mapping->backing_dev_info =&hugetlbfs_backing_dev_info; | |
515 | inode->i_atime = inode->i_mtime = inode->i_ctime = CURRENT_TIME; | |
a43a8c39 | 516 | INIT_LIST_HEAD(&inode->i_mapping->private_list); |
1da177e4 | 517 | info = HUGETLBFS_I(inode); |
71fe804b | 518 | mpol_shared_policy_init(&info->policy, NULL); |
1da177e4 LT |
519 | switch (mode & S_IFMT) { |
520 | default: | |
521 | init_special_inode(inode, mode, dev); | |
522 | break; | |
523 | case S_IFREG: | |
524 | inode->i_op = &hugetlbfs_inode_operations; | |
525 | inode->i_fop = &hugetlbfs_file_operations; | |
526 | break; | |
527 | case S_IFDIR: | |
528 | inode->i_op = &hugetlbfs_dir_inode_operations; | |
529 | inode->i_fop = &simple_dir_operations; | |
530 | ||
531 | /* directory inodes start off with i_nlink == 2 (for "." entry) */ | |
d8c76e6f | 532 | inc_nlink(inode); |
1da177e4 LT |
533 | break; |
534 | case S_IFLNK: | |
535 | inode->i_op = &page_symlink_inode_operations; | |
536 | break; | |
537 | } | |
538 | } | |
539 | return inode; | |
540 | } | |
541 | ||
542 | /* | |
543 | * File creation. Allocate an inode, and we're done.. | |
544 | */ | |
545 | static int hugetlbfs_mknod(struct inode *dir, | |
546 | struct dentry *dentry, int mode, dev_t dev) | |
547 | { | |
548 | struct inode *inode; | |
549 | int error = -ENOSPC; | |
550 | gid_t gid; | |
551 | ||
552 | if (dir->i_mode & S_ISGID) { | |
553 | gid = dir->i_gid; | |
554 | if (S_ISDIR(mode)) | |
555 | mode |= S_ISGID; | |
556 | } else { | |
77c70de1 | 557 | gid = current_fsgid(); |
1da177e4 | 558 | } |
77c70de1 | 559 | inode = hugetlbfs_get_inode(dir->i_sb, current_fsuid(), gid, mode, dev); |
1da177e4 LT |
560 | if (inode) { |
561 | dir->i_ctime = dir->i_mtime = CURRENT_TIME; | |
562 | d_instantiate(dentry, inode); | |
563 | dget(dentry); /* Extra count - pin the dentry in core */ | |
564 | error = 0; | |
565 | } | |
566 | return error; | |
567 | } | |
568 | ||
569 | static int hugetlbfs_mkdir(struct inode *dir, struct dentry *dentry, int mode) | |
570 | { | |
571 | int retval = hugetlbfs_mknod(dir, dentry, mode | S_IFDIR, 0); | |
572 | if (!retval) | |
d8c76e6f | 573 | inc_nlink(dir); |
1da177e4 LT |
574 | return retval; |
575 | } | |
576 | ||
577 | static int hugetlbfs_create(struct inode *dir, struct dentry *dentry, int mode, struct nameidata *nd) | |
578 | { | |
579 | return hugetlbfs_mknod(dir, dentry, mode | S_IFREG, 0); | |
580 | } | |
581 | ||
582 | static int hugetlbfs_symlink(struct inode *dir, | |
583 | struct dentry *dentry, const char *symname) | |
584 | { | |
585 | struct inode *inode; | |
586 | int error = -ENOSPC; | |
587 | gid_t gid; | |
588 | ||
589 | if (dir->i_mode & S_ISGID) | |
590 | gid = dir->i_gid; | |
591 | else | |
77c70de1 | 592 | gid = current_fsgid(); |
1da177e4 | 593 | |
77c70de1 | 594 | inode = hugetlbfs_get_inode(dir->i_sb, current_fsuid(), |
1da177e4 LT |
595 | gid, S_IFLNK|S_IRWXUGO, 0); |
596 | if (inode) { | |
597 | int l = strlen(symname)+1; | |
598 | error = page_symlink(inode, symname, l); | |
599 | if (!error) { | |
600 | d_instantiate(dentry, inode); | |
601 | dget(dentry); | |
602 | } else | |
603 | iput(inode); | |
604 | } | |
605 | dir->i_ctime = dir->i_mtime = CURRENT_TIME; | |
606 | ||
607 | return error; | |
608 | } | |
609 | ||
610 | /* | |
6649a386 | 611 | * mark the head page dirty |
1da177e4 LT |
612 | */ |
613 | static int hugetlbfs_set_page_dirty(struct page *page) | |
614 | { | |
d85f3385 | 615 | struct page *head = compound_head(page); |
6649a386 KC |
616 | |
617 | SetPageDirty(head); | |
1da177e4 LT |
618 | return 0; |
619 | } | |
620 | ||
726c3342 | 621 | static int hugetlbfs_statfs(struct dentry *dentry, struct kstatfs *buf) |
1da177e4 | 622 | { |
726c3342 | 623 | struct hugetlbfs_sb_info *sbinfo = HUGETLBFS_SB(dentry->d_sb); |
a5516438 | 624 | struct hstate *h = hstate_inode(dentry->d_inode); |
1da177e4 LT |
625 | |
626 | buf->f_type = HUGETLBFS_MAGIC; | |
a5516438 | 627 | buf->f_bsize = huge_page_size(h); |
1da177e4 LT |
628 | if (sbinfo) { |
629 | spin_lock(&sbinfo->stat_lock); | |
74a8a65c DG |
630 | /* If no limits set, just report 0 for max/free/used |
631 | * blocks, like simple_statfs() */ | |
632 | if (sbinfo->max_blocks >= 0) { | |
633 | buf->f_blocks = sbinfo->max_blocks; | |
634 | buf->f_bavail = buf->f_bfree = sbinfo->free_blocks; | |
635 | buf->f_files = sbinfo->max_inodes; | |
636 | buf->f_ffree = sbinfo->free_inodes; | |
637 | } | |
1da177e4 LT |
638 | spin_unlock(&sbinfo->stat_lock); |
639 | } | |
640 | buf->f_namelen = NAME_MAX; | |
641 | return 0; | |
642 | } | |
643 | ||
644 | static void hugetlbfs_put_super(struct super_block *sb) | |
645 | { | |
646 | struct hugetlbfs_sb_info *sbi = HUGETLBFS_SB(sb); | |
647 | ||
648 | if (sbi) { | |
649 | sb->s_fs_info = NULL; | |
650 | kfree(sbi); | |
651 | } | |
652 | } | |
653 | ||
96527980 CH |
654 | static inline int hugetlbfs_dec_free_inodes(struct hugetlbfs_sb_info *sbinfo) |
655 | { | |
656 | if (sbinfo->free_inodes >= 0) { | |
657 | spin_lock(&sbinfo->stat_lock); | |
658 | if (unlikely(!sbinfo->free_inodes)) { | |
659 | spin_unlock(&sbinfo->stat_lock); | |
660 | return 0; | |
661 | } | |
662 | sbinfo->free_inodes--; | |
663 | spin_unlock(&sbinfo->stat_lock); | |
664 | } | |
665 | ||
666 | return 1; | |
667 | } | |
668 | ||
669 | static void hugetlbfs_inc_free_inodes(struct hugetlbfs_sb_info *sbinfo) | |
670 | { | |
671 | if (sbinfo->free_inodes >= 0) { | |
672 | spin_lock(&sbinfo->stat_lock); | |
673 | sbinfo->free_inodes++; | |
674 | spin_unlock(&sbinfo->stat_lock); | |
675 | } | |
676 | } | |
677 | ||
678 | ||
e18b890b | 679 | static struct kmem_cache *hugetlbfs_inode_cachep; |
1da177e4 LT |
680 | |
681 | static struct inode *hugetlbfs_alloc_inode(struct super_block *sb) | |
682 | { | |
96527980 | 683 | struct hugetlbfs_sb_info *sbinfo = HUGETLBFS_SB(sb); |
1da177e4 LT |
684 | struct hugetlbfs_inode_info *p; |
685 | ||
96527980 CH |
686 | if (unlikely(!hugetlbfs_dec_free_inodes(sbinfo))) |
687 | return NULL; | |
e94b1766 | 688 | p = kmem_cache_alloc(hugetlbfs_inode_cachep, GFP_KERNEL); |
96527980 CH |
689 | if (unlikely(!p)) { |
690 | hugetlbfs_inc_free_inodes(sbinfo); | |
1da177e4 | 691 | return NULL; |
96527980 | 692 | } |
1da177e4 LT |
693 | return &p->vfs_inode; |
694 | } | |
695 | ||
1da177e4 LT |
696 | static void hugetlbfs_destroy_inode(struct inode *inode) |
697 | { | |
96527980 | 698 | hugetlbfs_inc_free_inodes(HUGETLBFS_SB(inode->i_sb)); |
1da177e4 LT |
699 | mpol_free_shared_policy(&HUGETLBFS_I(inode)->policy); |
700 | kmem_cache_free(hugetlbfs_inode_cachep, HUGETLBFS_I(inode)); | |
701 | } | |
702 | ||
f5e54d6e | 703 | static const struct address_space_operations hugetlbfs_aops = { |
1da177e4 | 704 | .readpage = hugetlbfs_readpage, |
800d15a5 NP |
705 | .write_begin = hugetlbfs_write_begin, |
706 | .write_end = hugetlbfs_write_end, | |
1da177e4 LT |
707 | .set_page_dirty = hugetlbfs_set_page_dirty, |
708 | }; | |
709 | ||
96527980 | 710 | |
51cc5068 | 711 | static void init_once(void *foo) |
96527980 CH |
712 | { |
713 | struct hugetlbfs_inode_info *ei = (struct hugetlbfs_inode_info *)foo; | |
714 | ||
a35afb83 | 715 | inode_init_once(&ei->vfs_inode); |
96527980 CH |
716 | } |
717 | ||
4b6f5d20 | 718 | const struct file_operations hugetlbfs_file_operations = { |
e63e1e5a | 719 | .read = hugetlbfs_read, |
1da177e4 LT |
720 | .mmap = hugetlbfs_file_mmap, |
721 | .fsync = simple_sync_file, | |
722 | .get_unmapped_area = hugetlb_get_unmapped_area, | |
723 | }; | |
724 | ||
92e1d5be | 725 | static const struct inode_operations hugetlbfs_dir_inode_operations = { |
1da177e4 LT |
726 | .create = hugetlbfs_create, |
727 | .lookup = simple_lookup, | |
728 | .link = simple_link, | |
729 | .unlink = simple_unlink, | |
730 | .symlink = hugetlbfs_symlink, | |
731 | .mkdir = hugetlbfs_mkdir, | |
732 | .rmdir = simple_rmdir, | |
733 | .mknod = hugetlbfs_mknod, | |
734 | .rename = simple_rename, | |
735 | .setattr = hugetlbfs_setattr, | |
736 | }; | |
737 | ||
92e1d5be | 738 | static const struct inode_operations hugetlbfs_inode_operations = { |
1da177e4 LT |
739 | .setattr = hugetlbfs_setattr, |
740 | }; | |
741 | ||
ee9b6d61 | 742 | static const struct super_operations hugetlbfs_ops = { |
1da177e4 LT |
743 | .alloc_inode = hugetlbfs_alloc_inode, |
744 | .destroy_inode = hugetlbfs_destroy_inode, | |
745 | .statfs = hugetlbfs_statfs, | |
149f4211 | 746 | .delete_inode = hugetlbfs_delete_inode, |
1da177e4 LT |
747 | .drop_inode = hugetlbfs_drop_inode, |
748 | .put_super = hugetlbfs_put_super, | |
10f19a86 | 749 | .show_options = generic_show_options, |
1da177e4 LT |
750 | }; |
751 | ||
752 | static int | |
753 | hugetlbfs_parse_options(char *options, struct hugetlbfs_config *pconfig) | |
754 | { | |
e73a75fa RD |
755 | char *p, *rest; |
756 | substring_t args[MAX_OPT_ARGS]; | |
757 | int option; | |
a137e1cc AK |
758 | unsigned long long size = 0; |
759 | enum { NO_SIZE, SIZE_STD, SIZE_PERCENT } setsize = NO_SIZE; | |
1da177e4 LT |
760 | |
761 | if (!options) | |
762 | return 0; | |
1da177e4 | 763 | |
e73a75fa RD |
764 | while ((p = strsep(&options, ",")) != NULL) { |
765 | int token; | |
b4c07bce LS |
766 | if (!*p) |
767 | continue; | |
e73a75fa RD |
768 | |
769 | token = match_token(p, tokens, args); | |
770 | switch (token) { | |
771 | case Opt_uid: | |
772 | if (match_int(&args[0], &option)) | |
773 | goto bad_val; | |
774 | pconfig->uid = option; | |
775 | break; | |
776 | ||
777 | case Opt_gid: | |
778 | if (match_int(&args[0], &option)) | |
779 | goto bad_val; | |
780 | pconfig->gid = option; | |
781 | break; | |
782 | ||
783 | case Opt_mode: | |
784 | if (match_octal(&args[0], &option)) | |
785 | goto bad_val; | |
75897d60 | 786 | pconfig->mode = option & 01777U; |
e73a75fa RD |
787 | break; |
788 | ||
789 | case Opt_size: { | |
e73a75fa RD |
790 | /* memparse() will accept a K/M/G without a digit */ |
791 | if (!isdigit(*args[0].from)) | |
792 | goto bad_val; | |
793 | size = memparse(args[0].from, &rest); | |
a137e1cc AK |
794 | setsize = SIZE_STD; |
795 | if (*rest == '%') | |
796 | setsize = SIZE_PERCENT; | |
e73a75fa RD |
797 | break; |
798 | } | |
1da177e4 | 799 | |
e73a75fa RD |
800 | case Opt_nr_inodes: |
801 | /* memparse() will accept a K/M/G without a digit */ | |
802 | if (!isdigit(*args[0].from)) | |
803 | goto bad_val; | |
804 | pconfig->nr_inodes = memparse(args[0].from, &rest); | |
805 | break; | |
806 | ||
a137e1cc AK |
807 | case Opt_pagesize: { |
808 | unsigned long ps; | |
809 | ps = memparse(args[0].from, &rest); | |
810 | pconfig->hstate = size_to_hstate(ps); | |
811 | if (!pconfig->hstate) { | |
812 | printk(KERN_ERR | |
813 | "hugetlbfs: Unsupported page size %lu MB\n", | |
814 | ps >> 20); | |
815 | return -EINVAL; | |
816 | } | |
817 | break; | |
818 | } | |
819 | ||
e73a75fa | 820 | default: |
b4c07bce LS |
821 | printk(KERN_ERR "hugetlbfs: Bad mount option: \"%s\"\n", |
822 | p); | |
823 | return -EINVAL; | |
e73a75fa RD |
824 | break; |
825 | } | |
1da177e4 | 826 | } |
a137e1cc AK |
827 | |
828 | /* Do size after hstate is set up */ | |
829 | if (setsize > NO_SIZE) { | |
830 | struct hstate *h = pconfig->hstate; | |
831 | if (setsize == SIZE_PERCENT) { | |
832 | size <<= huge_page_shift(h); | |
833 | size *= h->max_huge_pages; | |
834 | do_div(size, 100); | |
835 | } | |
836 | pconfig->nr_blocks = (size >> huge_page_shift(h)); | |
837 | } | |
838 | ||
1da177e4 | 839 | return 0; |
e73a75fa RD |
840 | |
841 | bad_val: | |
842 | printk(KERN_ERR "hugetlbfs: Bad value '%s' for mount option '%s'\n", | |
843 | args[0].from, p); | |
844 | return 1; | |
1da177e4 LT |
845 | } |
846 | ||
847 | static int | |
848 | hugetlbfs_fill_super(struct super_block *sb, void *data, int silent) | |
849 | { | |
850 | struct inode * inode; | |
851 | struct dentry * root; | |
852 | int ret; | |
853 | struct hugetlbfs_config config; | |
854 | struct hugetlbfs_sb_info *sbinfo; | |
855 | ||
10f19a86 MS |
856 | save_mount_options(sb, data); |
857 | ||
1da177e4 LT |
858 | config.nr_blocks = -1; /* No limit on size by default */ |
859 | config.nr_inodes = -1; /* No limit on number of inodes by default */ | |
77c70de1 DH |
860 | config.uid = current_fsuid(); |
861 | config.gid = current_fsgid(); | |
1da177e4 | 862 | config.mode = 0755; |
a137e1cc | 863 | config.hstate = &default_hstate; |
1da177e4 | 864 | ret = hugetlbfs_parse_options(data, &config); |
1da177e4 LT |
865 | if (ret) |
866 | return ret; | |
867 | ||
868 | sbinfo = kmalloc(sizeof(struct hugetlbfs_sb_info), GFP_KERNEL); | |
869 | if (!sbinfo) | |
870 | return -ENOMEM; | |
871 | sb->s_fs_info = sbinfo; | |
a137e1cc | 872 | sbinfo->hstate = config.hstate; |
1da177e4 LT |
873 | spin_lock_init(&sbinfo->stat_lock); |
874 | sbinfo->max_blocks = config.nr_blocks; | |
875 | sbinfo->free_blocks = config.nr_blocks; | |
876 | sbinfo->max_inodes = config.nr_inodes; | |
877 | sbinfo->free_inodes = config.nr_inodes; | |
878 | sb->s_maxbytes = MAX_LFS_FILESIZE; | |
a137e1cc AK |
879 | sb->s_blocksize = huge_page_size(config.hstate); |
880 | sb->s_blocksize_bits = huge_page_shift(config.hstate); | |
1da177e4 LT |
881 | sb->s_magic = HUGETLBFS_MAGIC; |
882 | sb->s_op = &hugetlbfs_ops; | |
883 | sb->s_time_gran = 1; | |
884 | inode = hugetlbfs_get_inode(sb, config.uid, config.gid, | |
885 | S_IFDIR | config.mode, 0); | |
886 | if (!inode) | |
887 | goto out_free; | |
888 | ||
889 | root = d_alloc_root(inode); | |
890 | if (!root) { | |
891 | iput(inode); | |
892 | goto out_free; | |
893 | } | |
894 | sb->s_root = root; | |
895 | return 0; | |
896 | out_free: | |
897 | kfree(sbinfo); | |
898 | return -ENOMEM; | |
899 | } | |
900 | ||
9a119c05 | 901 | int hugetlb_get_quota(struct address_space *mapping, long delta) |
1da177e4 LT |
902 | { |
903 | int ret = 0; | |
904 | struct hugetlbfs_sb_info *sbinfo = HUGETLBFS_SB(mapping->host->i_sb); | |
905 | ||
906 | if (sbinfo->free_blocks > -1) { | |
907 | spin_lock(&sbinfo->stat_lock); | |
9a119c05 AL |
908 | if (sbinfo->free_blocks - delta >= 0) |
909 | sbinfo->free_blocks -= delta; | |
1da177e4 LT |
910 | else |
911 | ret = -ENOMEM; | |
912 | spin_unlock(&sbinfo->stat_lock); | |
913 | } | |
914 | ||
915 | return ret; | |
916 | } | |
917 | ||
9a119c05 | 918 | void hugetlb_put_quota(struct address_space *mapping, long delta) |
1da177e4 LT |
919 | { |
920 | struct hugetlbfs_sb_info *sbinfo = HUGETLBFS_SB(mapping->host->i_sb); | |
921 | ||
922 | if (sbinfo->free_blocks > -1) { | |
923 | spin_lock(&sbinfo->stat_lock); | |
9a119c05 | 924 | sbinfo->free_blocks += delta; |
1da177e4 LT |
925 | spin_unlock(&sbinfo->stat_lock); |
926 | } | |
927 | } | |
928 | ||
454e2398 DH |
929 | static int hugetlbfs_get_sb(struct file_system_type *fs_type, |
930 | int flags, const char *dev_name, void *data, struct vfsmount *mnt) | |
1da177e4 | 931 | { |
454e2398 | 932 | return get_sb_nodev(fs_type, flags, data, hugetlbfs_fill_super, mnt); |
1da177e4 LT |
933 | } |
934 | ||
935 | static struct file_system_type hugetlbfs_fs_type = { | |
936 | .name = "hugetlbfs", | |
937 | .get_sb = hugetlbfs_get_sb, | |
938 | .kill_sb = kill_litter_super, | |
939 | }; | |
940 | ||
941 | static struct vfsmount *hugetlbfs_vfsmount; | |
942 | ||
1da177e4 LT |
943 | static int can_do_hugetlb_shm(void) |
944 | { | |
945 | return likely(capable(CAP_IPC_LOCK) || | |
946 | in_group_p(sysctl_hugetlb_shm_group) || | |
947 | can_do_mlock()); | |
948 | } | |
949 | ||
9d66586f | 950 | struct file *hugetlb_file_setup(const char *name, size_t size) |
1da177e4 LT |
951 | { |
952 | int error = -ENOMEM; | |
953 | struct file *file; | |
954 | struct inode *inode; | |
955 | struct dentry *dentry, *root; | |
956 | struct qstr quick_string; | |
86a264ab | 957 | struct user_struct *user = current_user(); |
1da177e4 | 958 | |
5bc98594 AM |
959 | if (!hugetlbfs_vfsmount) |
960 | return ERR_PTR(-ENOENT); | |
961 | ||
1da177e4 LT |
962 | if (!can_do_hugetlb_shm()) |
963 | return ERR_PTR(-EPERM); | |
964 | ||
86a264ab | 965 | if (!user_shm_lock(size, user)) |
1da177e4 LT |
966 | return ERR_PTR(-ENOMEM); |
967 | ||
968 | root = hugetlbfs_vfsmount->mnt_root; | |
9d66586f | 969 | quick_string.name = name; |
1da177e4 LT |
970 | quick_string.len = strlen(quick_string.name); |
971 | quick_string.hash = 0; | |
972 | dentry = d_alloc(root, &quick_string); | |
973 | if (!dentry) | |
974 | goto out_shm_unlock; | |
975 | ||
1da177e4 | 976 | error = -ENOSPC; |
77c70de1 DH |
977 | inode = hugetlbfs_get_inode(root->d_sb, current_fsuid(), |
978 | current_fsgid(), S_IFREG | S_IRWXUGO, 0); | |
1da177e4 | 979 | if (!inode) |
ce8d2cdf | 980 | goto out_dentry; |
1da177e4 | 981 | |
b45b5bd6 | 982 | error = -ENOMEM; |
a5516438 AK |
983 | if (hugetlb_reserve_pages(inode, 0, |
984 | size >> huge_page_shift(hstate_inode(inode)), NULL)) | |
b45b5bd6 DG |
985 | goto out_inode; |
986 | ||
1da177e4 LT |
987 | d_instantiate(dentry, inode); |
988 | inode->i_size = size; | |
989 | inode->i_nlink = 0; | |
ce8d2cdf DH |
990 | |
991 | error = -ENFILE; | |
992 | file = alloc_file(hugetlbfs_vfsmount, dentry, | |
993 | FMODE_WRITE | FMODE_READ, | |
994 | &hugetlbfs_file_operations); | |
995 | if (!file) | |
b4d232e6 | 996 | goto out_dentry; /* inode is already attached */ |
ce8d2cdf | 997 | |
1da177e4 LT |
998 | return file; |
999 | ||
b45b5bd6 DG |
1000 | out_inode: |
1001 | iput(inode); | |
1da177e4 LT |
1002 | out_dentry: |
1003 | dput(dentry); | |
1004 | out_shm_unlock: | |
86a264ab | 1005 | user_shm_unlock(size, user); |
1da177e4 LT |
1006 | return ERR_PTR(error); |
1007 | } | |
1008 | ||
1009 | static int __init init_hugetlbfs_fs(void) | |
1010 | { | |
1011 | int error; | |
1012 | struct vfsmount *vfsmount; | |
1013 | ||
e0bf68dd PZ |
1014 | error = bdi_init(&hugetlbfs_backing_dev_info); |
1015 | if (error) | |
1016 | return error; | |
1017 | ||
1da177e4 LT |
1018 | hugetlbfs_inode_cachep = kmem_cache_create("hugetlbfs_inode_cache", |
1019 | sizeof(struct hugetlbfs_inode_info), | |
20c2df83 | 1020 | 0, 0, init_once); |
1da177e4 | 1021 | if (hugetlbfs_inode_cachep == NULL) |
e0bf68dd | 1022 | goto out2; |
1da177e4 LT |
1023 | |
1024 | error = register_filesystem(&hugetlbfs_fs_type); | |
1025 | if (error) | |
1026 | goto out; | |
1027 | ||
1028 | vfsmount = kern_mount(&hugetlbfs_fs_type); | |
1029 | ||
1030 | if (!IS_ERR(vfsmount)) { | |
1031 | hugetlbfs_vfsmount = vfsmount; | |
1032 | return 0; | |
1033 | } | |
1034 | ||
1035 | error = PTR_ERR(vfsmount); | |
1036 | ||
1037 | out: | |
1038 | if (error) | |
1039 | kmem_cache_destroy(hugetlbfs_inode_cachep); | |
e0bf68dd PZ |
1040 | out2: |
1041 | bdi_destroy(&hugetlbfs_backing_dev_info); | |
1da177e4 LT |
1042 | return error; |
1043 | } | |
1044 | ||
1045 | static void __exit exit_hugetlbfs_fs(void) | |
1046 | { | |
1047 | kmem_cache_destroy(hugetlbfs_inode_cachep); | |
1048 | unregister_filesystem(&hugetlbfs_fs_type); | |
e0bf68dd | 1049 | bdi_destroy(&hugetlbfs_backing_dev_info); |
1da177e4 LT |
1050 | } |
1051 | ||
1052 | module_init(init_hugetlbfs_fs) | |
1053 | module_exit(exit_hugetlbfs_fs) | |
1054 | ||
1055 | MODULE_LICENSE("GPL"); |