losetup - set up and control loop devices


   Get info:

        losetup loopdev

        losetup -l [-a]

        losetup -j file [-o offset]

   Detach a loop device:

        losetup -d loopdev...

   Detach all associated loop devices:

        losetup -D

   Print the name of the first unused loop device:

        losetup -f

   Set up a loop device:

        losetup [-o offset] [--sizelimit size]
                [-Pr] [--show] -f|loopdev file

   Resize a 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
   corresponding loop device is shown.  If no option is  given,  all  loop
   devices are shown.

   Note  that the old output format (i.e. losetup -a) with comma-delimited
   strings is deprecated in favour of the --list output format.

   It's possible to create more independent  loop  devices  for  the  same
   backing  file.   This  setup  may  be  dangerous,  can cause data loss,
   corruption and overwrites.  Use --nooverlap to avoid this problem.


   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 the  status  of  all  loop  devices.   Note  that  not  all
          information  is accessible for non-root users.  See also --list.
          The old output format (as printed without --list) is deprecated.

   -c, --set-capacity loopdev
          Force the loop driver to reread the 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.

          Enable or disable direct I/O for the backing file.  The optional
          argument  can  be either on or off.  If the argument is omitted,
          it defaults to on.

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

   -L, --nooverlap
          Check for conflicts between loop devices to avoid situation when
          the  same  backing  file is shared between more loop devices. If
          the file is already used  by  another  device  then  re-use  the
          device  rather  than a new one. The option makes sense only with

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

   -J, --json
          Use JSON format for --list output.

   -l, --list
          If  a  loop  device  or  the  -a  option is specified, print the
          default columns for either the specified loop device or all loop
          devices;  the  default  is to print info about all devices.  See
          also --output, --noheadings --json 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  the  columns  that  are  to  be  printed for the --list

   -P, --partscan
          Force the kernel to scan the partition table on a newly  created
          loop device.

   --raw  Use the raw --list output format.

   -r, --read-only
          Set up a read-only loop device.

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

   --show Display the name of the assigned loop device if  the  -f  option
          and a file argument are present.

   -v, --verbose
          Verbose mode.

   -V, --version
          Display version information and exit.

   -h, --help
          Display help text and exit.


   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
   configured and 2 if an error occurred which prevented  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


          enables debug output.


   Karel  Zak  <kzak@redhat.com>,  based  on  the  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/.


Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.

Free Software

Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.

Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.

Free Books

The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.

Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.


Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.

Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.