Update upstream source from tag 'upstream/1.3.0+git20220115'

[sven/fuse-exfat.git] / label / exfatlabel.8

diff --git a/label/exfatlabel.8 b/label/exfatlabel.8
new file mode 100644 (file)
index 0000000..4f55510
--- /dev/null
+++ b/label/exfatlabel.8
@@ -0,0 +1,48 @@
+.\" Copyright (C) 2011-2018  Andrew Nayenko
+.\"
+.TH EXFATLABEL 8 "September 2017"
+.SH NAME
+.B exfatlabel
+\- get or set an exFAT file system label
+.SH SYNOPSIS
+.B exfatlabel
+[
+.B \-V
+]
+.I device
+[
+.I label
+]
+
+.SH DESCRIPTION
+.B exfatlabel
+reads or changes an exFAT file system label (volume name).
+
+If
+.I label
+argument is present,
+.B exfatlabel
+sets the new volume name. Empty label ('') removes volume name. Label can be
+up to 15 characters. This limit is shorter if characters beyond Unicode BMP
+are used because internally label is stored in UTF-16.
+
+If
+.I label
+argument is omitted,
+.B exfatlabel
+just prints current volume name.
+
+.SH COMMAND LINE OPTIONS
+Command line options available:
+.TP
+.BI \-V
+Print version and copyright.
+
+.SH EXIT CODES
+Zero is returned on success. Any other code means an error.
+
+.SH AUTHOR
+Andrew Nayenko
+
+.SH SEE ALSO
+.BR mkexfatfs (8)