Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
FLS(1)			     General Commands Manual			  FLS(1)

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

SYNOPSIS
     fls  [-adDFlpruvV] [-m mnt ] [-z zone ] [-f fstype ] [-s seconds ] [-i img-
     type ] [-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 di-
	    rectory depth on recursive runs with a '+' sign.

     -r     Recursively  display  directories.	This will not follow deleted di-
	    rectories, 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 zoneThe ASCII string of the time zone of the original system.  For exam-
	    ple, 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=fls&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help