losetup man page on Archlinux

Printed from http://www.polarhome.com/service/man/?qf=losetup&af=0&tf=2&of=Archlinux

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
       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

       -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

       details see cryptsetup(8).

       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


	      # 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>


util-linux			   July 2003			    LOSETUP(8)

List of man pages available for Archlinux



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