Editing How to create a Recycle Bin (or Trash can) for the CLI rm command

This wiki page gives step by step instructions on how to create a recycle bin (or Trash Can) for the rm (delete) command. 

==Why should I create a Recycle Bin?==
The ext2 and ext3 file systems used by linux operating systems (and used by Synology NAS's) is well known for its unfriendliness in recovering accidentally deleted files. Unlike FAT and NTFS once a ext2 ext3 file is deleted all pointers and information relating to where the file is/was on the disk are irreversibly destroyed. This makes the easy recovering of accidentally deleted files impossible, even if you imediately want to recover it after mistakenly deleting it, i.e. you haven't written over the file.

Without a recycle bin often the only way to recover the contents of a file is to sweep the hard disk for byte streams and load then into a file and then use a hex editor or similar to try to find the contents of your file, but unless you want to spend hours/days trying to recover a file, you will need a recycle bin.

==Overview of the Mod==
#Create a directory to put any deleted files/directories in
#Create a direcotry to store your sript
#Create a script to be called instead of the rm command which '''moves''' files or directories into the recycle bin directory
#Set an alias to call your script every time the rm command is used
#Set a cronjob to regularly remove/purge (actually delete) files/directories older that X days old from the RecycleBin (in this example I use 7 days but you could configure what you want)
#If you have the knowledge and need you can modify the script to limit diskspace, or perhaps purge based on a diskspace limit, rather than age. If you do please add it to this wiki.

==Limitations==
#This will only move to the RecycleBin files/directories that were deleted using the rm command in the Command Line Interface.
#It will not recycle files/directories deleted via a Samba Share (i.e. when using a ftp client such as windows file explorer)
#It will not recycle files/directories deleted by the Synology "File Station"
#If you delete a file/directory with the same name twice or more, before the first has been purged from the RecycleBin, the second and subsequent files will have a version number tagged onto the end of the file/directory name.
#If you wish to restore a deleted file/directory, you will need to manually move/copy it from the RecycleBin directory back to where you want it within the 7 days before the file/direcotry is purged from the RecycleBin. You can change the default setting of 7 days if required.

==The Mod==
#Using the Synology web gui create a folder "RecycleBin" on volume1. If you want you can select that this directory is not visible.
#Using the Synology web gui create a folder "my_scripts" on volume1. If you want you can select that this directory is not visible.
#Enable the Command Line Interface
#Login to the CLI as root
#Then change directory to your script folder, e.g. "cd /volume1/my_scripts"
#Use vi to create a script file rm_replacement.sh, e.g. "vi rm_replacement.sh"
#Press the "i" key to enter vi's input mode and then copy the contents of the script rm_replacement.sh below and paste it into vi
#Save changes to the file and close vi, e.g. press [ESC] and then type "ZZ". Note: capital Z's
#Now give the script file execution privileges, "chmod 700 rm_replacement.sh"
#Now add the alias command to your .profile file, e.g "vi ~/.profile", and then add at the bottom of the file "alias rm='sh /volume1/my_scripts/rm_replacement.sh
#Close the CLI session and reopen it again to get ash to read the modified .profile file
#Your script will now run instead of rm, try "rm -h" to get the help. You could also create a directory and put some files in it and then delete them using rm to see how it work. Check the content of the RecycleBin with "dir /volume1/RecycleBin".
#Now we create a cronjob to daily check the RecycleBin and delete anything over 7 days old from it (you can change this period if you want). Enter "vi /etc/crontab"
#Add the last line given in the section crontab below as the last line in your crontab file. Note it is TAB characters that seperate values in crontab, not spaces.
#To change how long files/directories are left in the RecycleBin change the parameter -mtime from "+7" to meet your requirments.
#Save the file and exit vi, e.g. [ESC]ZZ
#You need to get cron to re-read the crontab file, to do this reboot the NAS, e.g. "reboot"
#Finished

===Scripts===

===="rm_replacement.sh" script====
Below is the /volume1/my_scripts/rm_replacement.sh script.

<pre>
#!/bin/bash
#
#  This script is to be called by an alias of the rm command
#  e.g. using the entry...
#  alias rm='sh /volume1/my_scripts/rm_replacement.sh'
#  in your $HOME/.profile or $HOME/.bashrc file
#
#  It will move rm files to /volume1/RecycleBin
#  You need to create the directory /volume1/RecycleBin if
#  it doesn't already exist
#
#  If a file/directory with the same name already exists in the
#  RecycleBin, the file/directory already in the RecycleBin
#  will be renamed taging "_X" on to the end where
#  X is an incremental number and then the newly rm'd
#  file/directory will be copied into the RecycleBin
#
#  Consequently the latest version of the file will be its normall
#  name, without any extension.

RM_OPT=""
FILES=""
VERBOSE="n"
FORCE="n"

while [ "$1" ]; do
    case "$1" in
        "-v") VERBOSE="y" ;;
        "-f") FORCE="y" ;;
        "--help" | "-h")
            echo "Usage rm [options] file1 file2 ..."
            echo
            echo "Moves the files to /volume1/RecycleBin. Files can be either files or"
            echo "directories."
            echo
            echo "Options:"
            echo " -v           verbose mode"
            echo " -h, --help   this help message"
            echo " --help-rm    help message of /bin/rm"
            echo " -f           force processing with the normal rm command (/bin/rm)"
            echo " All other options are ignored when moving files. When removing"
            echo " permanently, these options are passed to /bin/rm"
            echo
            exit 0
        ;;
        "--help-rm")
            /bin/rm --help
            exit 0
        ;;
        -*) RM_OPT=$RM_OPT" "$1 ;;
        *)
            if [ "$VERBOSE" = "y" ]; then
                echo $1
            fi
            if [ "$FORCE" = "y" ]; then
                /bin/rm -f $RM_OPT $1
            else
                if [ -e "$1" ]; then
                    if [ -e "/volume1/RecycleBin/$(basename $1)" ]; then
                        version=2
                        while [ -e "/volume1/RecycleBin/$(basename $1)_$version" ]; do
                        let version=$version+1
                        done
                        mv "/volume1/RecycleBin/$(basename $1)" "/volume1/RecycleBin/$(basename $1)_$version"
                    fi
                    mv "$1" "/volume1/RecycleBin"
                fi
            fi
        ;;
    esac
    shift
done
</pre>

===="/etc/crontab" entry example====
Below is an example crontab file. It is the last line you want to copy and paste into your existing /etc/crontab file

<pre>
#minute hour    mday    month   wday    who     command
53      0       *       *       5       root    /usr/sbin/ntpdate -b time.nist.gov
57      0       *       *       *       root    find /volume1/RecycleBin/ -mtime +7 -type f -exec rm "{}" ";"
</pre>