[PATCH v1 1/2] loop.4: Document LOOP_SET_DIRECT_IO

[PATCH v1 1/2] loop.4: Document LOOP_SET_DIRECT_IO

[Yang Xu]

Signed-off-by: Yang Xu <xuyang2018.jy@cn.fujitsu.com>
---
 man4/loop.4 | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/man4/loop.4 b/man4/loop.4
index a56586fe6..afb1d05c5 100644
--- a/man4/loop.4
+++ b/man4/loop.4
@@ -152,6 +152,13 @@ Resize a live loop device.
 One can change the size of the underlying backing store and then use this
 operation so that the loop driver learns about the new size.
 This operation takes no argument.
+.TP
+.BR LOOP_SET_DIRECT_IO " (since Linux 4.10)"
+.\" commit ab1cb278bc7027663adbfb0b81404f8398437e11
+Set DIRECT IO mode on the loop device. So it can be used to open backing
+file. The (third)
+.BR ioctl(2)
+argument is an unsigned long value. non-zero represents direct IO mode.
 .PP
 Since Linux 2.6, there are two new
 .BR ioctl (2)
-- 
2.18.0

[PATCH v1 2/2] loop.4: Document LOOP_SET_BLOCK_SIZE

[Yang Xu]

Signed-off-by: Yang Xu <xuyang2018.jy@cn.fujitsu.com>
---
 man4/loop.4 | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/man4/loop.4 b/man4/loop.4
index afb1d05c5..9fd2b3eb4 100644
--- a/man4/loop.4
+++ b/man4/loop.4
@@ -159,6 +159,13 @@ Set DIRECT IO mode on the loop device. So it can be used to open backing
 file. The (third)
 .BR ioctl(2)
 argument is an unsigned long value. non-zero represents direct IO mode.
+.TP
+.BR LOOP_SET_BLOCK_SIZE " (since Linux 4.14)"
+.\" commit 89e4fdecb51cf5535867026274bc97de9480ade5
+Set the block size of the loop device. The (third)
+.BR ioctl(2)
+argument is an unsigned long value. This value must be 2 to the power of N
+and in range [512,pagesize]. Otherwise, it will get EINVAL error.
 .PP
 Since Linux 2.6, there are two new
 .BR ioctl (2)
-- 
2.18.0

Re: [PATCH v1 1/2] loop.4: Document LOOP_SET_DIRECT_IO

[Michael Kerrisk (man-pages)]

On 1/6/20 8:42 AM, Yang Xu wrote:
> Signed-off-by: Yang Xu <xuyang2018.jy@cn.fujitsu.com>

Hello Yang Xu. Thanks. Patch applied.

Cheers,

Michael

> ---
>  man4/loop.4 | 7 +++++++
>  1 file changed, 7 insertions(+)
> 
> diff --git a/man4/loop.4 b/man4/loop.4
> index a56586fe6..afb1d05c5 100644
> --- a/man4/loop.4
> +++ b/man4/loop.4
> @@ -152,6 +152,13 @@ Resize a live loop device.
>  One can change the size of the underlying backing store and then use this
>  operation so that the loop driver learns about the new size.
>  This operation takes no argument.
> +.TP
> +.BR LOOP_SET_DIRECT_IO " (since Linux 4.10)"
> +.\" commit ab1cb278bc7027663adbfb0b81404f8398437e11
> +Set DIRECT IO mode on the loop device. So it can be used to open backing
> +file. The (third)
> +.BR ioctl(2)
> +argument is an unsigned long value. non-zero represents direct IO mode.
>  .PP
>  Since Linux 2.6, there are two new
>  .BR ioctl (2)
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/

Re: [PATCH v1 2/2] loop.4: Document LOOP_SET_BLOCK_SIZE

[Michael Kerrisk (man-pages)]

On 1/6/20 8:42 AM, Yang Xu wrote:
> Signed-off-by: Yang Xu <xuyang2018.jy@cn.fujitsu.com>

Thanks, Yang Xu. Patch applied.

Cheers,

Michael

> ---
>  man4/loop.4 | 7 +++++++
>  1 file changed, 7 insertions(+)
> 
> diff --git a/man4/loop.4 b/man4/loop.4
> index afb1d05c5..9fd2b3eb4 100644
> --- a/man4/loop.4
> +++ b/man4/loop.4
> @@ -159,6 +159,13 @@ Set DIRECT IO mode on the loop device. So it can be used to open backing
>  file. The (third)
>  .BR ioctl(2)
>  argument is an unsigned long value. non-zero represents direct IO mode.
> +.TP
> +.BR LOOP_SET_BLOCK_SIZE " (since Linux 4.14)"
> +.\" commit 89e4fdecb51cf5535867026274bc97de9480ade5
> +Set the block size of the loop device. The (third)
> +.BR ioctl(2)
> +argument is an unsigned long value. This value must be 2 to the power of N
> +and in range [512,pagesize]. Otherwise, it will get EINVAL error.
>  .PP
>  Since Linux 2.6, there are two new
>  .BR ioctl (2)
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/