losetup man page on Archlinux

Man page or keyword search:  
man Server   11224 pages
apropos Keyword Search (all sections)
Output format
Archlinux logo
[printable version]

LOSETUP(8)		     System Administration		    LOSETUP(8)

       losetup - set up and control loop devices

       Get info:

	    losetup loopdev

	    losetup -l [-a]

	    losetup -j file [-o offset]

       Delete loop:

	    losetup -d loopdev...

       Delete all used loop devices:

	    losetup -D

       Print name of first unused loop device:

	    losetup -f

       Setup loop device:

	    losetup [-o offset] [--sizelimit size]
		    [-p pfd] [-rP] {-f[--show]|loopdev} file

       Resize loop device:

	    losetup -c loopdev

       losetup	is  used to associate loop devices with regular files or block
       devices, to detach loop devices and to  query  the  status  of  a  loop
       device. If only the loopdev argument is given, the status of the corre‐
       sponding loop device is shown.

       Note that the old output format (e.g. losetup -a) with comma  delimited
       strings	is deprecated in favour of the --list output format (e.g. los‐
       etup -a -l).

       +The size and offset arguments may be followed  by  the	multiplicative
       +suffixes  KiB=1024,  MiB=1024*1024,  and so on for GiB, TiB, PiB, EiB,
       ZiB and YiB +(the "iB" is optional, e.g. "K" has the  same  meaning  as
       "KiB")  or  the	suffixes +KB=1000, MB=1000*1000, and so on for GB, TB,
       PB, EB, ZB and YB.

       -a, --all
	      show status of all loop devices. Note that not  all  information
	      are accessible for non-root users. See also --list. The old out‐
	      put format (as printed without --list) is deprecated.

       -c, --set-capacity loopdev
	      force loop driver to reread size of the file associated with the
	      specified loop device

       -d, --detach loopdev...
	      detach  the  file	 or  device associated with the specified loop

       -D, --detach-all
	      detach all associated loop devices

       -f, --find
	      find the first  unused  loop  device.  If	 a  file  argument  is
	      present, use this device. Otherwise, print its name

       -h, --help
	      print help

       -j, --associated file
	      show status of all loop devices associated with given file

       -l, --list
	      if  a  loop  device or the -a option is specified, print default
	      columns for  either  the	specified  loop	 device	 or  all  loop
	      devices,	default	 is to print info about all devices.  See also
	      --output, --noheadings and --raw.

       -n, --noheadings
	      don't print headings for --list output format

       -o, --offset offset
	      the data start is moved offset bytes into the specified file  or

       -O, --output columns
	      specify which columns are to be printed for the --list output

       --sizelimit size
	      the  data	 end  is set to no more than size bytes after the data

       -P, --partscan
	      force kernel to scan  partition  table  on  newly	 created  loop

       --raw  use raw --list output format

       -r, --read-only
	      setup read-only loop device

       --show print  device  name  if  the  -f	option and a file argument are

       -v, --verbose
	      verbose mode

       Cryptoloop is no longer	supported  in  favor  of  dm-crypt.  For  more
       details see cryptsetup(8).

       losetup returns 0 on success, nonzero on failure. When losetup displays
       the status of a loop device, it returns 1 if the device is not  config‐
       ured  and  2  if an error occurred which prevented from determining the
       status of the device.

	      loop block devices

	      loop control device

       The following commands can be used as an	 example  of  using  the  loop

	      # dd if=/dev/zero of=~/file.img bs=1MiB count=10
	      # losetup --find --show ~/file.img
	      # mkfs -t ext2 /dev/loop0
	      # mount /dev/loop0 /mnt
	      # umount /dev/loop0
	      # losetup --detach /dev/loop0

       Karel  Zak  <kzak@redhat.com>,  based on original version from Theodore
       Ts'o <tytso@athena.mit.edu>

       The losetup command is part of the util-linux package and is  available
       from ftp://ftp.kernel.org/pub/linux/utils/util-linux/.

util-linux			   July 2003			    LOSETUP(8)

List of man pages available for Archlinux

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net