1.\" Copyright (c) 2014 The FreeBSD Foundation 2.\" All rights reserved. 3.\" 4.\" This software was developed by Edward Tomasz Napierala under sponsorship 5.\" from the FreeBSD Foundation. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions 9.\" are met: 10.\" 1. Redistributions of source code must retain the above copyright 11.\" notice, this list of conditions and the following disclaimer. 12.\" 2. Redistributions in binary form must reproduce the above copyright 13.\" notice, this list of conditions and the following disclaimer in the 14.\" documentation and/or other materials provided with the distribution. 15.\" 16.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND 17.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 18.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 19.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE 20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26.\" SUCH DAMAGE. 27.\" 28.\" $FreeBSD$ 29.\" 30.Dd April 26, 2017 31.Dt FSTYP 8 32.Os 33.Sh NAME 34.Nm fstyp 35.Nd determine filesystem type 36.Sh SYNOPSIS 37.Nm 38.Op Fl l 39.Op Fl s 40.Op Fl u 41.Ar special 42.Sh DESCRIPTION 43The 44.Nm 45utility is used to determine the filesystem type on a given device. 46It can recognize ISO-9660, exFAT, Ext2, FAT, NTFS, and UFS filesystems. 47When the 48.Fl u 49flag is specified, 50.Nm 51also recognizes certain additional metadata formats that cannot be 52handled using 53.Xr mount 8 , 54such as 55.Xr geli 8 56providers, and 57ZFS pools. 58.Pp 59The filesystem name is printed to the standard output 60as, respectively: 61.Bl -item -offset indent -compact 62.It 63cd9660 64.It 65exfat 66.It 67ext2fs 68.It 69geli 70.It 71msdosfs 72.It 73ntfs 74.It 75ufs 76.It 77zfs 78.El 79.Pp 80Because 81.Nm 82is built specifically to detect filesystem types, it differs from 83.Xr file 1 84in several ways. 85The output is machine-parsable, filesystem labels are supported, 86the utility runs sandboxed using 87.Xr capsicum 4 , 88and does not try to recognize any file format other than filesystems. 89.Pp 90These options are available: 91.Bl -tag -width ".Fl l" 92.It Fl l 93In addition to filesystem type, print filesystem label if available. 94.It Fl s 95Ignore file type. 96By default, 97.Nm 98only works on regular files and disk-like device nodes. 99Trying to read other file types might have unexpected consequences or hang 100indefinitely. 101.It Fl u 102Include filesystems and devices that cannot be mounted directly by 103.Xr mount 8 . 104.El 105.Sh EXIT STATUS 106The 107.Nm 108utility exits 0 on success, and >0 if an error occurs or the filesystem 109type is not recognized. 110.Sh SEE ALSO 111.Xr file 1 , 112.Xr capsicum 4 , 113.Xr autofs 5 , 114.Xr geli 8 , 115.Xr glabel 8 , 116.Xr mount 8 , 117.Xr zpool 8 118.Sh HISTORY 119The 120.Nm 121command appeared in 122.Fx 10.2 . 123.Sh AUTHORS 124.An -nosplit 125The 126.Nm 127utility was developed by 128.An Edward Tomasz Napierala Aq Mt trasz@FreeBSD.org 129under sponsorship from the FreeBSD Foundation. 130ZFS and GELI support was added by 131.An Allan Jude Aq Mt allanjude@FreeBSD.org . 132