NAME

       fls - List file and directory names in a disk image.

SYNOPSIS

       fls  [-adDFlpruvV]  [-m  mnt  ]  [-z  zone ] [-f fstype ] [-s seconds ] [-i imgtype ] [-o imgoffset ] [-b
       dev_sector_size] image [images] [ inode ]

DESCRIPTION

       fls lists the files and directory names in the image and can display file names of recently deleted files
       for  the  directory  using  the given inode.  If the inode argument is not given, the inode value for the
       root directory is used. For example, on an NTFS file system it would be 5 and on a Ext3  file  system  it
       would be 2.

       The arguments are as follows:

       -a     Display the "." and ".." directory entries (by default it does not)

       -d     Display deleted entries only

       -D     Display directory entries only

       -f fstype
              The  type  of  file system.  Use '-f list' to list the supported file system types.  If not given,
              autodetection methods are used.

       -F     Display file (all non-directory) entries only.

       -l     Display file details in long format.  The following contents are displayed:

              file_type inode file_name mod_time acc_time chg_time cre_time size uid gid

       -m mnt Display files in time machine format so that a timeline can be     created with  mactime(1).   The
              string given as mnt will be prepended to the file names as the mounting point (for example /usr).

       -p     Display the full path for each entry.  By default it denotes the directory depth on recursive runs
              with a '+' sign.

       -r     Recursively display directories.  This will not follow deleted directories, because it can't.

       -s seconds
              The time skew of the original system in seconds.  For example, if  the  original  system  was  100
              seconds slow, this value would be -100.  This is only used if -l or -m are given.

       -i imgtype
              Identify  the type of image file, such as raw.  Use '-i list' to list the supported types.  If not
              given, autodetection methods are used.

       -o imgoffset
              The sector offset where the file system starts in the image.

       -b dev_sector_size
              The size, in bytes, of the underlying device sectors.  If not given, the value in the image format
              is used (if it exists) or 512-bytes is assumed.

       -u     Display undeleted entries only

       -v     Verbose output to stderr.

       -V     Display version.

       -z zone
              The ASCII string of the time zone of the original system.  For example, EST or GMT.  These strings
              must be defined by your operating system and may vary.

       image [images]
              The disk or partition image to read, whose format is given with '-i'.  Multiple image  file  names
              can  be  given if the image is split into multiple segments.  If only one image file is given, and
              its name is the first in a sequence (e.g., as indicated by ending  in  '.001'),  subsequent  image
              segments will be included automatically.

       Once  the  inode  has been determined, the file can be recovered using icat(1) from The Coroners Toolkit.
       The amount of information recovered from deleted file  entries  varies  depending  on  the  system.   For
       example,  on  Linux, a recently deleted file can be easily recovered, while in Solaris not even the inode
       can be determined.  If you just want to find what file name belongs to an inode,  it  is  easier  to  use
       ffind(1).

EXAMPLES

       To get a list of all files and directories in an image use:

            # fls -r image 2

            or just (if no inode is specified, the root directory inode is used):

            # fls -r image

       To get the full path of deleted files in a given directory:

            # fls -d -p image 29

       To get the mactime output do:

            # fls -m /usr/local image 2

       If you have a disk image and the file system starts in sector 63, use:

            # fls -o 63 disk-img.dd

       If you have a disk image that is split use:

            # fls -i "split" -o 63 disk-1.dd disk-2.dd disk-3.dd

SEE ALSO

       ffind(1), icat(1)

AUTHOR

       Brian Carrier <carrier at sleuthkit dot org>

       Send documentation updates to <doc-updates at sleuthkit dot org>

                                                                                                          FLS(1)