This is an old revision of the document!
How to fun_plug
Background info
On startup DSM-G600 will run /etc/rc.sh which will mount the various filesystems and initialize the drive.
... touch /tmp/boot_finished /usr/sbin/chk_fun_plug &
/usr/sbin/chk_fun_plug will check for file called fun_plug on the disks root and then execute it.
#!/bin/sh sleep 30 Dir_Len=28 Filename_Len=26 CUSTOMIZEHDPATH=/sys/custom/shared_name/HD file=$(find "$CUSTOMIZEHDPATH"/*) HD_Path=`expr substr "$file" "$Dir_Len" "$Filename_Len"` HD_Path=$HD_Path"a2" if [ -e /mnt/$HD_Path/fun_plug ]; then echo "function plug enable" /mnt/$HD_Path/fun_plug fi
Warning: This was just background information about how DSM-G600 finds and executes fun_plug. All scripts above this warning should not be entered into your fun_plug or any other scripts.
Installing fun_plug
There are 5 ways to setup a working fun_plug file:
- To a new hard drive using Linux
- To an already partitioned hard drive using Linux
- To an already partitioned hard drive using Linux and Samba
- To an already partitioned hard drive using Windows and cygwin
- To a running DSM using FTP from any Operating System
1. To a new hard drive using Linux
- Connect your new hard drive to a Linux (ext3 supported) PC.
- Run terminal as root user.
- Fire up fdisk using following command
fdisk /dev/hdx
orfdisk /dev/sdx
if you have a SATA or USB hard drive. The x is your hard drive position, for example Primary Master is a, Primary Slave is b, Secondary Master is c and Secondary Slave is d. SATA and USB hard drives are usually a. - Now we are going to make a swap partition.
- When you are inside fdisk press
n
- Then
p
- And then
1
- And then
Enter key
- And finally
+512M
- Now we are going to make an ext3 partition for your files. You can also make more than one partition for your files. For example if you do not want to store your files to ext3 partition and you want to use fat32 instead, or if you want to use a chroot environment and want to avoid the chmod bug at bootup.
- Press
n
- Then
p
- Then
2
- Then press the
Enter key
- And now press the
Enter key
if you want to make only one ext3 partition. If you are not sure what to do then you should press theEnter key
. But if you want to make one or more extra partitions then you must figure out how you are going to allocate your drive space among all those partitions you are going to make. For example if you want to store most of your files to a FAT32 partition then you should enter+100M
to make a 100MB ext3 partition. - If you did choose to make more than one partition for your files, then proceed with step 17, otherwise go to step 18.
- Now press
n
thenp
after that3
and nowEnter key
andEnter key
once more. - Now we are going to set the partition type to
swap
. - Press
T
- Then
1
- And then
82
- If you chose to make more than one partition for your files then proceed with step 23, otherwise go to step 24.
- Now you have to choose a file system for your extra partition. You can leave it as ext3 or change it to FAT32. To change it FAT32, press
T
then3
and thenc
- Now you can review your partition table by pressing
p
, if it looks good then pressw
to write changes to hard disk. If you think something went wrong then pressq
and start again, starting with step 3. - Now we are going to format newly created partitions.
- To format the swap partition run
mkswap /dev/hdx1
- Next we are going to format the ext3 partition with the following command line
mke2fs -I 128 -j /dev/hdx2
- And if you chose to make a second partition to your files then we must format this one also. If you chose it to be FAT32 at the 23rd step, then you must run
mkdosfs /dev/hdx3
- And finally we are going to copy the fun_plug file to your ext3 partition.
- We first mount the ext3 partition with this command line
mkdir /mnt/dsmg600disk || mount /dev/hdx2 /mnt/dsmg600disk
- Now create an empty fun_plug file with this command
touch /mnt/dsmg600disk/fun_plug
- And now we are going to make it an a executable with this command
chmod 777 /mnt/dsmg600disk/fun_plug
- Now run
ls -la /mnt/dsmg600disk/fun_plug
to make sure that we did it correctly. You should see-rwxrwxrwx 1 root root 0 some-date-and-time /mnt/dsmg600disk/fun_plug
- Optionally you can also install telnet here.
- Now we are almost done, we just need to unmount ext3 partition with
umount /mnt/dsmg600disk
command. - And now you can take out the hard drive from your computer and install it in your DSM-G600.
2. To an already partitioned hard drive using Linux
- Take your hard disk out of your DSM-G600.
- Connect your already partitioned hard drive to a Linux (ext3 supported) PC.
- Run terminal as root user.
- We need first mount ext3 partition with this command line
mkdir /mnt/dsmg600disk || mount /dev/hdx2 /mnt/dsmg600disk
. The x is your hard drive position, for example Primary Master is a, Primary Slave is b, Secondary Master is c and Secondary Slave is d. SATA and USB hard drives are most cases a. - Now create empty fun_plug file with this command
touch /mnt/dsmg600disk/fun_plug
- And now we are going to make it an a executable with this command
chmod 777 /mnt/dsmg600disk/fun_plug
- Now run
ls -la /mnt/dsmg600disk/fun_plug
to make sure that we made it correctly. You should see-rwxrwxrwx 1 root root 0 some-date-and-time /mnt/dsmg600disk/fun_plug
- Optionally if you like you can also install telnet here.
- Now we are almost done, just need to unmount ext3 partition with
umount /mnt/dsmg600disk
command. - And now you can take out your hard drive from your computer and install it back to your DSM-G600.
3. To an already partitioned hard drive using Linux and Samba
- Boot up your DSM-G600.
- Mount DSM-G600 share using following command line
mount -t smbfs -o username=admin //<insert dsmg IP here>/HDD_a /mnt/somedir
- Enter your password you specified for admin user in web interface.
- Run
touch /mnt/somedir/fun_plug
andchmod 777 /mnt/somedir/fun_plug
- Optionally if you like you can also install telnet here.
- Finally run
umount /mnt/somedir
and reboot your DSM-G600.
4. To an already partitioned hard drive using Windows and cygwin
- …
5. to a running DSM using FTP from any Operating System
To do this, you have to have at least the 1.01 firmware. Please update if you have an older version.
- You will have to enable FTP through the admin pages and set up an ftp user.
- Create a test fun_plug on your system.
- Connect to your DSM using a command line ftp client (in windows: start / run / ftp)
- change to the right directory: cd /HD_a2
- upload your fun_plug: put fun_plug
- make it executable: chmod 777 fun_plug (in windows ftp: literal site chmod 777 fun_plug)
- quit ftp: quit
and you're done. You may edit the fun_plug via samba (windows share) from now on, the permissions will stick.
Using fun_plug
Windows users should note that the fun_plug file must be in unix file format (LF for newline) and not in Windows (CR LF for newline). One suggested editor for Windows is UltraEdit which let you save the file in both formats. To test out if fun_plug works, you can simply add following lines to your fun_plug and reboot.
#!/bin/sh
dmesg > /mnt/HD_a2/dmesg.out
After boot up you should see dmesg.out file at the root of your DSM-G600 hard disk.
If you have not familiar with Unix shell scripting then I suggest you to read some docs about it.