Differences
This shows you the differences between the selected revision and the current version of the page.
| howto:fun_plug 2008/03/20 13:18 | howto:fun_plug 2017/09/06 18:41 current | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ====== How to fun_plug ====== | + | ====== How to fun_plug ====== |
| - | Creating a ''fun_plug'' file on your hard disk allows you to run a custom boot script with no firmware update necessary! | + | Creating a ''fun_plug'' file on your hard disk allows you to run a custom boot script. |
| - | + | This feature allows additional software to run on the DNS-323. | |
| - | you can also use fonz's fun_plug to get up and running faster http://www.inreto.de/dns323/fun-plug/ | + | |
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| + | The most popular fun_plug implementation is [[http://www.inreto.de/dns323/fun-plug/|Fonz fun_plug]]. | ||
| + | For a good set of tutorial see [[howto:ffp]]. | ||
| ===== How fun_plug works: ===== | ===== How fun_plug works: ===== | ||
| - | When the DNS-323 boots it reads ''[[information:dlink_files:102b114:etc:initab|/etc/inittab]]'' which will execute the ''[[information:dlink_files:102b114:etc:rc.sh|/etc/rc.sh]]'' script, just as the [[http://dsmg600.info/howto:fun_plug|DSM-G600]]: | + | When the DNS-323 boots it reads ''[[information:dlink_files:102b114:etc:initab|/etc/inittab]]'' which will execute the ''[[information:dlink_files:102b114:etc:rc.sh|/etc/rc.sh]]'' script, just as the [[http://dns323.kood.org/dsmg600/howto:fun_plug|DSM-G600]]: |
| <code bash> | <code bash> | ||
| ::sysinit:/etc/rc.sh | ::sysinit:/etc/rc.sh | ||
| Line 59: | Line 43: | ||
| Next step is to transfer this file and give it proper rights, i.e. the right to execute. | Next step is to transfer this file and give it proper rights, i.e. the right to execute. | ||
| + | |||
| + | |||
| Line 64: | Line 50: | ||
| - Enable FTP through the admin pages and set up an ftp user. | - Enable FTP through the admin pages and set up an ftp user. | ||
| - | - Create a test fun_plug on your system. | + | - Create a test fun_plug file on your system. |
| - Connect to your DNS-323 using a command line ftp client (in windows: start / run / ftp) | - Connect to your DNS-323 using a command line ftp client (in windows: start / run / ftp) | ||
| - | - Change to the right directory: cd / | + | - Change to the root directory: cd / |
| - Upload your fun_plug: ''put fun_plug'' | - Upload your fun_plug: ''put fun_plug'' | ||
| - Make it executable: chmod 777 fun_plug | - Make it executable: chmod 777 fun_plug | ||
| Line 81: | Line 67: | ||
| ---- | ---- | ||
| + | |||
| Line 90: | Line 77: | ||
| Version 1.01 and 1.02 have proper umask set so the files //should// have proper rights. But; better to be safe than sorry and ftp to your unit and make sure the file has at least ''rwx------'' rights. | Version 1.01 and 1.02 have proper umask set so the files //should// have proper rights. But; better to be safe than sorry and ftp to your unit and make sure the file has at least ''rwx------'' rights. | ||
| - | 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. | + | 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 or Notepad++ which let you save the file in both formats. |
| Line 99: | Line 86: | ||
| - Create the fun_plug using "echo dmesg >> /mnt/HD_a2/fun_plug" | - Create the fun_plug using "echo dmesg >> /mnt/HD_a2/fun_plug" | ||
| - | ==== Inserting one using and external system ==== | ||
| - | See the instructions for [[http://dsmg600.info/howto:fun_plug|DSM-G600]]. | ||
| + | ==== Inserting one using an external system ==== | ||
| + | See the instructions for [[http://dns323.kood.org/dsmg600/howto:fun_plug|DSM-G600]]. | ||
| + | ==== File Permissions ==== | ||
| + | |||
| + | An important point in the fun_plug installation. The "fun_plug" file on the device needs to have the executable permissions. Otherwise known as 777 for the chmod command. This will give it read write and execute by all users on the system. | ||
| + | |||
| + | This is achieved by executing the chmod command (given below) from the directory of the fun_plug. | ||
| + | |||
| + | chmod 777 fun_plug | ||
| + | |||
| + | The key is being able to do this. In earlier versions of the D-Link firmware, this could be done through ftp. All one had to do is set-up an account with read write permissions. Then through a command line version of an ftp client one could execute this command. | ||
| + | |||
| + | The D-Link firmware version 1.09 does not allow FTP users to change permissions. However the earlier version 1.06 does. If users are stuck with changing permissions, you should install firmware 1.06. Then proceed to install fun_plug. If the user wants features in the latest firmware they can still upgrade and retain fun_plug functionality provided that the fun_plug script has kept the executable permissions. | ||
| Line 109: | Line 107: | ||
| So; you have a fun_plug working and want to do something with it. Start with [[telnet]] and maybe a [[chroot_debian|debian]] Sarge chroot system. Upgrade your [[firefly|iTunes server]] or make your ftp server working in a [[open_ports_ftpd|NAT]]'ed environment. | So; you have a fun_plug working and want to do something with it. Start with [[telnet]] and maybe a [[chroot_debian|debian]] Sarge chroot system. Upgrade your [[firefly|iTunes server]] or make your ftp server working in a [[open_ports_ftpd|NAT]]'ed environment. | ||
| - | For a comprehensive list of what you can do with your DNS-323 take a look at the [[howto:ffp| forum howto list]]. | + | For a comprehensive list of what you can do with your DNS-323 take a look at the [[howto:ffp| howtos list]]. |
| - | + | ||
| - | But remember, always have //fun//, ;-), and be aware that you're now in a position where you can easily <hi #ffff00>[[wp>bricked|brick]]</hi> your unit. | + | |
| + | But remember, always have //fun//, ;-), and be aware that you're now in a position where you can easily [[wp>bricked|brick]] your unit. | ||
| ===== Having issues? ===== | ===== Having issues? ===== | ||
| Visit out our [[information:Beginner's FAQ]] for more information about what to do. | Visit out our [[information:Beginner's FAQ]] for more information about what to do. | ||
| + | |||
| + | A simple step by step description can be found here: [[Simple fun_plug StepByStep]] | ||
