summaryrefslogtreecommitdiffstats
path: root/man4/loop.4
diff options
context:
space:
mode:
Diffstat (limited to 'man4/loop.4')
-rw-r--r--man4/loop.432
1 files changed, 16 insertions, 16 deletions
diff --git a/man4/loop.4 b/man4/loop.4
index 253784a34..72ec56c77 100644
--- a/man4/loop.4
+++ b/man4/loop.4
@@ -17,7 +17,7 @@ but to the blocks of
a regular file in a filesystem or to another block device.
This can be useful for example to provide a block device for a filesystem
image stored in a file, so that it can be mounted with the
-.BR mount (8)
+.MR mount 8
command.
You could do
.P
@@ -32,20 +32,20 @@ $ \fBsudo mount /dev/loop4 /myloopdev\fP
.in
.P
See
-.BR losetup (8)
+.MR losetup 8
for another example.
.P
A transfer function can be specified for each loop device for
encryption and decryption purposes.
.P
The following
-.BR ioctl (2)
+.MR ioctl 2
operations are provided by the loop block device:
.TP
.B LOOP_SET_FD
Associate the loop device with the open file whose file descriptor is
passed as the (third)
-.BR ioctl (2)
+.MR ioctl 2
argument.
.TP
.B LOOP_CLR_FD
@@ -53,7 +53,7 @@ Disassociate the loop device from any file descriptor.
.TP
.B LOOP_SET_STATUS
Set the status of the loop device using the (third)
-.BR ioctl (2)
+.MR ioctl 2
argument.
This argument is a pointer to a
.I loop_info
@@ -130,14 +130,14 @@ and
.B LOOP_GET_STATUS
Get the status of the loop device.
The (third)
-.BR ioctl (2)
+.MR ioctl 2
argument must be a pointer to a
.IR "struct loop_info" .
.TP
.BR LOOP_CHANGE_FD " (since Linux 2.6.5)"
Switch the backing store of the loop device to the new file identified
file descriptor specified in the (third)
-.BR ioctl (2)
+.MR ioctl 2
argument, which is an integer.
This operation is possible only if the loop device is read-only and
the new backing store is the same size and type as the old backing store.
@@ -154,7 +154,7 @@ This operation takes no argument.
Set DIRECT I/O mode on the loop device, so that
it can be used to open backing file.
The (third)
-.BR ioctl (2)
+.MR ioctl 2
argument is an unsigned long value.
A nonzero represents direct I/O mode.
.TP
@@ -162,7 +162,7 @@ A nonzero represents direct I/O mode.
.\" commit 89e4fdecb51cf5535867026274bc97de9480ade5
Set the block size of the loop device.
The (third)
-.BR ioctl (2)
+.MR ioctl 2
argument is an unsigned long value.
This value must be a power of two in the range
[512,pagesize];
@@ -174,7 +174,7 @@ error results.
.\" commit 3448914e8cc550ba792d4ccc74471d1ca4293aae
Setup and configure all loop device parameters in a single step using
the (third)
-.BR ioctl (2)
+.MR ioctl 2
argument.
This argument is a pointer to a
.I loop_config
@@ -216,7 +216,7 @@ in
.RE
.P
Since Linux 2.6, there are two new
-.BR ioctl (2)
+.MR ioctl 2
operations:
.TP
.B LOOP_SET_STATUS64
@@ -259,7 +259,7 @@ and to add and remove loop devices from the system.
To perform these operations, one first opens
.I /dev/loop\-control
and then employs one of the following
-.BR ioctl (2)
+.MR ioctl 2
operations:
.TP
.B LOOP_CTL_GET_FREE
@@ -270,7 +270,7 @@ This operation takes no argument.
.B LOOP_CTL_ADD
Add the new loop device whose device number is specified
as a long integer in the third
-.BR ioctl (2)
+.MR ioctl 2
argument.
On success, the device index is returned as the result of the call.
If the device is already allocated, the call fails with the error
@@ -279,7 +279,7 @@ If the device is already allocated, the call fails with the error
.B LOOP_CTL_REMOVE
Remove the loop device whose device number is specified
as a long integer in the third
-.BR ioctl (2)
+.MR ioctl 2
argument.
On success, the device number is returned as the result of the call.
If the device is in use, the call fails with the error
@@ -357,5 +357,5 @@ main(int argc, char *argv[])
}
.EE
.SH SEE ALSO
-.BR losetup (8),
-.BR mount (8)
+.MR losetup 8 ,
+.MR mount 8