# HG changeset patch
# User Mychaela Falconia <falcon@freecalypso.org>
# Date 1580788370 0
# Node ID f315cdb1555ff6e02f07b86aeb394faa25bd0876
# Parent  a0754c98fc2b32660149cd41b92a13316f0b1259
fc-fsio help updated for new rm command

diff -r a0754c98fc2b -r f315cdb1555f rvinterf/etmsync/fsio.help
--- a/rvinterf/etmsync/fsio.help	Tue Feb 04 03:36:08 2020 +0000
+++ b/rvinterf/etmsync/fsio.help	Tue Feb 04 03:52:50 2020 +0000
@@ -4,7 +4,6 @@
 
 cpout			Copy content out of device FFS to host file system
 cpout-file		Copy out a single file
-delete			Delete FFS object
 dieid			Retrieve Calypso die ID via ETM query
 exec			Execute a command script
 exit			Exit from fc-fsio
@@ -23,6 +22,7 @@
 pirelli-magnetite-init	Initialize FFS for FC Magnetite fw on Pirelli target
 preformat		Preformat FFS on device (dangerous!)
 readlink		Raw interface to ffs_readlink() API call
+rm			Delete FFS object
 set-imeisv		Write /etc/IMEISV or /pcm/IMEI file
 set-pcm-string		Write /pcm/CGxx files
 set-rfcap		Write /gsm/com/rfcap file
@@ -54,18 +54,6 @@
 to a single file and not a directory, and skips the pathname validation and
 xlstat query steps toward that end.
 
-=== delete
-delete ffs-pathname
-
-This command deletes the named object in the device FFS, which must be a regular
-file, an empty directory or a symlink.
-
-Note that in classic UNIX there are two different "delete file system object"
-elementary operations: unlink for regular files or symlinks and rmdir for empty
-directories, but TI's FFS implementation provides a single ffs_remove() API call
-instead for deleting all 3 object types; our delete command is the interface to
-this ffs_remove() API call.
-
 === dieid
 This command sends an ETM query for the Calypso die ID to the running firmware
 on the target and displays the returned result.
@@ -214,6 +202,21 @@
 the returned response as a hex dump.  Use ls -l (or ll) as a more user-friendly
 interface.
 
+=== rm
+rm [-f] ffs-pathname
+
+This command deletes the named object in the device FFS, which must be a regular
+file, an empty directory or a symlink.
+
+Note that in classic UNIX there are two different "delete file system object"
+elementary operations: unlink for regular files or symlinks and rmdir for empty
+directories, but TI's FFS implementation provides a single ffs_remove() API call
+instead for deleting all 3 object types; our rm command is the interface to
+this ffs_remove() API call.
+
+If the -f option is given, the condition where the object to be deleted does not
+exist is treated as not-an-error; all other errors are still reported.
+
 === set-imeisv
 set-imeisv fc  XXXXXXXX-YYYYYY-ZZ	# write /etc/IMEISV
 set-imeisv pcm XXXXXXXX-YYYYYY-ZZ	# write /pcm/IMEI