svn commit: r363611 - head/usr.bin/truncate
Fernando Apesteguía
fernape at FreeBSD.org
Mon Jul 27 15:25:05 UTC 2020
Author: fernape (ports committer)
Date: Mon Jul 27 15:25:04 2020
New Revision: 363611
URL: https://svnweb.freebsd.org/changeset/base/363611
Log:
truncate(1): Add EXAMPLES section
Add four simple examples showing the use of -c, -r and -s
Approved by: manpages (bcr@)
Differential Revision: https://reviews.freebsd.org/D25774
Modified:
head/usr.bin/truncate/truncate.1
Modified: head/usr.bin/truncate/truncate.1
==============================================================================
--- head/usr.bin/truncate/truncate.1 Mon Jul 27 15:09:07 2020 (r363610)
+++ head/usr.bin/truncate/truncate.1 Mon Jul 27 15:25:04 2020 (r363611)
@@ -25,7 +25,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd December 19, 2006
+.Dd July 27, 2020
.Dt TRUNCATE 1
.Os
.Sh NAME
@@ -143,6 +143,43 @@ If the operation fails for an argument,
.Nm
will issue a diagnostic
and continue processing the remaining arguments.
+.Sh EXAMPLES
+Adjust the size of the file
+.Pa test_file
+to 10 Megabytes but do not create it if it does not exist:
+.Bd -literal -offset indent
+truncate -c -s +10M test_file
+.Ed
+.Pp
+Same as above but create the file if it does not exist:
+.Bd -literal -offset indent
+truncate -s +10M test_file
+ls -l test_file
+-rw-r--r-- 1 root wheel 10485760 Jul 22 18:48 test_file
+.Ed
+.Pp
+Adjust the size of
+.Pa test_file
+to the size of the kernel and create another file
+.Pa test_file2
+with the same size:
+.Bd -literal -offset indent
+truncate -r /boot/kernel/kernel test_file test_file2
+ls -l /boot/kernel/kernel test_file*
+-r-xr-xr-x 1 root wheel 31352552 May 15 14:18 /boot/kernel/kernel*
+-rw-r--r-- 1 root wheel 31352552 Jul 22 19:15 test_file
+-rw-r--r-- 1 root wheel 31352552 Jul 22 19:15 test_file2
+.Ed
+.Pp
+Downsize
+.Pa test_file
+in 5 Megabytes:
+.Bd -literal -offset indent
+# truncate -s -5M test_file
+ls -l test_file*
+-rw-r--r-- 1 root wheel 26109672 Jul 22 19:17 test_file
+-rw-r--r-- 1 root wheel 31352552 Jul 22 19:15 test_file2
+.Ed
.Sh SEE ALSO
.Xr dd 1 ,
.Xr touch 1 ,
More information about the svn-src-all
mailing list