Commit b9f61c3c0c8daed9844870bc9358e6d9fdb7eb61
Committed by
Al Viro
Al Viro
1 parent
7898575fc8
Exists in
smarc-l5.0.0_1.0.0-ga
and in
5 other branches
documentation: drop vmtruncate
Removed vmtruncate Signed-off-by: Marco Stornelli <marco.stornelli@gmail.com> Signed-off-by: Al Viro <viro@zeniv.linux.org.uk>
Showing 3 changed files with 1 additions and 18 deletions Side-by-side Diff
Documentation/filesystems/Locking
| ... | ... | @@ -80,7 +80,6 @@ |
| 80 | 80 | readlink: no |
| 81 | 81 | follow_link: no |
| 82 | 82 | put_link: no |
| 83 | -truncate: yes (see below) | |
| 84 | 83 | setattr: yes |
| 85 | 84 | permission: no (may not block if called in rcu-walk mode) |
| 86 | 85 | get_acl: no |
| ... | ... | @@ -96,11 +95,6 @@ |
| 96 | 95 | Additionally, ->rmdir(), ->unlink() and ->rename() have ->i_mutex on |
| 97 | 96 | victim. |
| 98 | 97 | cross-directory ->rename() has (per-superblock) ->s_vfs_rename_sem. |
| 99 | - ->truncate() is never called directly - it's a callback, not a | |
| 100 | -method. It's called by vmtruncate() - deprecated library function used by | |
| 101 | -->setattr(). Locking information above applies to that call (i.e. is | |
| 102 | -inherited from ->setattr() - vmtruncate() is used when ATTR_SIZE had been | |
| 103 | -passed). | |
| 104 | 98 | |
| 105 | 99 | See Documentation/filesystems/directory-locking for more detailed discussion |
| 106 | 100 | of the locking scheme for directory operations. |
Documentation/filesystems/porting
| ... | ... | @@ -281,7 +281,7 @@ |
| 281 | 281 | |
| 282 | 282 | [mandatory] |
| 283 | 283 | |
| 284 | - ->truncate is going away. The whole truncate sequence needs to be | |
| 284 | + ->truncate is gone. The whole truncate sequence needs to be | |
| 285 | 285 | implemented in ->setattr, which is now mandatory for filesystems |
| 286 | 286 | implementing on-disk size changes. Start with a copy of the old inode_setattr |
| 287 | 287 | and vmtruncate, and the reorder the vmtruncate + foofs_vmtruncate sequence to |
Documentation/filesystems/vfs.txt
| ... | ... | @@ -350,7 +350,6 @@ |
| 350 | 350 | int (*readlink) (struct dentry *, char __user *,int); |
| 351 | 351 | void * (*follow_link) (struct dentry *, struct nameidata *); |
| 352 | 352 | void (*put_link) (struct dentry *, struct nameidata *, void *); |
| 353 | - void (*truncate) (struct inode *); | |
| 354 | 353 | int (*permission) (struct inode *, int); |
| 355 | 354 | int (*get_acl)(struct inode *, int); |
| 356 | 355 | int (*setattr) (struct dentry *, struct iattr *); |
| ... | ... | @@ -430,16 +429,6 @@ |
| 430 | 429 | (i.e. page that was installed when the symbolic link walk |
| 431 | 430 | started might not be in the page cache at the end of the |
| 432 | 431 | walk). |
| 433 | - | |
| 434 | - truncate: Deprecated. This will not be called if ->setsize is defined. | |
| 435 | - Called by the VFS to change the size of a file. The | |
| 436 | - i_size field of the inode is set to the desired size by the | |
| 437 | - VFS before this method is called. This method is called by | |
| 438 | - the truncate(2) system call and related functionality. | |
| 439 | - | |
| 440 | - Note: ->truncate and vmtruncate are deprecated. Do not add new | |
| 441 | - instances/calls of these. Filesystems should be converted to do their | |
| 442 | - truncate sequence via ->setattr(). | |
| 443 | 432 | |
| 444 | 433 | permission: called by the VFS to check for access rights on a POSIX-like |
| 445 | 434 | filesystem. |