• puppy does not operate on multiple files, so you can not use wildcards such as FileName-*.rec. Instead you must run the puppy command for each file that you wish processed. There are some examples further on that show you how it's done.

 Usage: puppy [-pPqv] [-d <device>] -c <command> [args]
 -p             - packet header output to stderr
 -P             - full packet dump output to stderr
 -q             - quiet transfers - no progress updates
 -v             - verbose output to stderr
 -d <device>    - USB device (must be usbfs)
                  for example /proc/bus/usb/001/003
 -c <command>   - one of size, dir, get, put, rename, delete, mkdir, reboot, cancel, turbo
 args           - optional arguments, as required by each command

 Version: 1.12, Compiled: Sep 21 2005=]

Downloading a recording from the Toppy.

 puppy -c get 'DataFiles\Happy Tree Friends Christmas Special.rec' 'TreeFriends.rec'

 puppy -c put usbmon_1.3.tap 'ProgramFiles\Auto Start\usbmon.tap'

Turbo mode

Turbo mode is not recommended because it has a severe negative impact on the performance of the Toppy. It will disable the remote control and prevent recording of shows.

The turbo command takes either 0 (zero) or 1 (one) as the argument to disable or enable turbo mode. Once turbo is enabled, it will persist until explicitly turned off.

Turn turbo mode on: (:table border=0 width=100% bgcolor=#eeffee:) (:cell:)

 puppy -c turbo 1

(:tableend:)

Turn turbo mode off: (:table border=0 width=100% bgcolor=#eeffee:) (:cell:)

 puppy -c turbo 0

(:tableend:)

This will download all files from the ICE directory on the Toppy to the current directory. (:table border=0 width=100% bgcolor=#eeffee:) (:cell:)

  puppy -c dir ICE | awk '/^f/ { system(sprintf("puppy -c get \"ICE\\%s\" \"%s\"\n", substr($0, 49), substr($0,49))) }' 

(:tableend:)

  -c <command>   - one of size, dir, get, put, rename, delete, mkdir, reboot, cancel, turbo

The turbo command takes either 0 (zero) or 1 (one) as the argument to disable or enable turbo mode. Once turbo is enabled, it will persist until explicitly turned off.

 cd /share/hdd/data/public

 puppy[=

 puppy -c size[=

 puppy -c dir[=

 puppy -c dir [='DataFiles?'

 puppy -t -c get 'DataFiles\Happy Tree Friends Christmas Special.rec' 'TreeFriends.rec'

 puppy -c put ProgressBarKeys.tap 'ProgramFiles\Auto Start\ProgressBarKeys.tap'

 puppy -c rename 'DataFiles\Pingu.rec' 'DataFiles\Pingu\Pingu-20.rec'

 puppy -c delete 'DataFiles\Johnny Mnemonic.rec'

 puppy -c reboot

 [=cd

 puppy -c get 'DataFiles?\Enterprise-4.rec' sharename/video/Enterprise/Rajiin.rec=]

  for i in *.tgd; do echo Uploading $i ; puppy -c put $i ProgramFiles\\$i ; done 

tableend?

Upgrading the NSLU2 to handle large files and making new files accessible to everyone.

table border=0 width=100% bgcolor=#eeffee? cell?

 ipkg update
 ipkg install busybox

tableend?

Put the following lines into a file named ~/.profile table border=0 width=100% bgcolor=#eeeeff? cell?

 PATH=/opt/sbin:/opt/bin:$PATH
 export PATH
 umask 0

tableend?

Changing file permissions

The following will grant both read and write permissions for the named file to all users: table border=0 width=100% bgcolor=#eeffee? cell?

 chmod a+rw FileName

Mounting a share from a network connected PC and transfering files directly to the PC.

table border=0 width=100% bgcolor=#eeffee? cell?

 cd
 mkdir -p /mnt/smb/computername/sharename
 smbmount //computername/sharename /mnt/smb/computername/sharename -o username=myName,password=myPassword
 ln -s /mnt/smb/computername/sharename sharename
 puppy -c get 'DataFiles\Enterprise-4.rec' sharename/video/Enterprise/Rajiin.rec

tableend?

Some general points

• Please remember that puppy runs under Linux and therefore all input is case sensitive, so FileName.rec is not the same as filename.rec as far as puppy is concerned.
• The Toppy uses the backslash (\) as the directory separator. In contrast, Linux uses the forward slash (/) to separate directories.
• The backslash is used by Linux shells as a special escape character to modify the meaning of the character that follows it. To prevent this behaviour (and to allow spaces in file names), the filename arguments should be enclosed in single forward quotes (') - usually found on the right hand side of the keyboard, near the enter key. An alternative is to escape the backslash itself and use the \\ idiom. If this is all too confusing, just make sure you follow the supplied examples.
• puppy does not operate on multiple files, so you can not use wildcards such as FileName-*.rec. Instead you must run the puppy command for each file that you wish processed.

  -q             - quiet transfers - no progress updates

  -c <command>   - one of size, dir, get, put, rename, delete, mkdir, reboot, cancel

Uploading a TAP to the Auto Start directory

table border=0 width=100% bgcolor=#eeffee? cell?

 puppy -c put ProgressBarKeys.tap 'ProgramFiles\Auto Start\ProgressBarKeys.tap'

tableend?

Moving a recording to a different directory

table border=0 width=100% bgcolor=#eeffee? cell?

 puppy -c rename 'DataFiles\Pingu.rec' 'DataFiles\Pingu\Pingu-20.rec'

tableend?

Rebooting the Toppy

table border=0 width=100% bgcolor=#eeffee? cell?

 puppy -c reboot

tableend?

Copying multiple files

This shell command will copy all Topfield Guide Data (.tgd) files from current directory to the Toppy.

  for i in *.tgd; do puppy -c put $i ProgramFiles\\$i ; done 

Please remember that this is Linux and Linux is case sensitive! So Tree is not equal to tree. Also note the direction of the slash on the NSLU2 side.

Downloading a tap to the Auto Start directory

table border=0 width=100% bgcolor=#eeffee? cell?

 puppy -c put ProgressBarKeys?.tap 'ProgramFiles\Auto Start\ProgressBarKeys.tap'

tableend?

Changing current directory to the NSLU2 public data directory.

This is not really a puppy command, but it makes it easier to upload and download data from the directory where it resides, rather than having to supply long pathnames.

table border=0 width=100% bgcolor=#eeffee? cell?

 cd /share/hdd/data/public

tableend?

Getting an overview of puppy command line arguments

Just typing puppy on the command line will show a short description of the options accepted. This page shows further examples of the most common tasks.

Just typing puppy on the command line will show a short description of the options accepted. This page shows examples of the most common tasks. table border=0 width=100% bgcolor=#eeffee? cell?

 puppy
 Usage: puppy [-pPtv] [-d <device>] -c <command> [args]
  -p             - packet header output to stderr
  -P             - full packet dump output to stderr
  -t             - turbo mode on for file xfers
  -v             - verbose output to stderr
  -d <device>    - USB device (must be usbfs)
                   for example /proc/bus/usb/001/003
  -c <command>   - one of size, dir, get, put, rename, delete, reboot, cancel
  args           - optional arguments, as required by each command

tableend?

Finding disk capacity and amount of free space

table border=0 width=100% bgcolor=#eeffee? cell?

 puppy -c size
 Total   78148608 kiB   76317 MiB   74 GiB
 Free    28578816 kiB   27909 MiB   27 GiB

tableend?

Listing the top level directories on the Toppy

table border=0 width=100% bgcolor=#eeffee? cell?

 puppy -c dir
 d                    0 Wed Jan  1 00:00:00 2003 DataFiles
 d                    0 Wed Jan  1 00:00:00 2003 ProgramFiles
 d                    0 Wed Jan  1 00:00:00 2003 MP3

tableend?

Listing the recordings on the Toppy

table border=0 width=100% bgcolor=#eeffee? cell?

 puppy -c dir 'DataFiles'
 d                    0 Thu Jan  1 09:59:59 1970 ..
 f           1751955456 Fri Dec 24 15:00:00 2004 3rd Rock from the Sun.rec
 f            624701440 Thu Dec 23 23:00:00 2004 Happy Tree Friends Christmas Special.rec
 f           2747820032 Tue Dec  7 23:45:00 2004 Voyager-2.rec
 f           7255777280 Sat Dec 25 23:25:00 2004 Johnny Mnemonic.rec

tableend?

Downloading a recording from the Toppy, with turbo mode enabled.

This command will transfer a recorded program from the Toppy to the current directory on the NSLU2. The resulting file will be named TreeFriends.rec table border=0 width=100% bgcolor=#eeffee? cell?

 puppy -t -c get 'DataFiles\Happy Tree Friends Christmas Special.rec' 'TreeFriends.rec'
 100.00%

tableend?

Deleting a recording

table border=0 width=100% bgcolor=#eeffee? cell?

 puppy -c delete 'DataFiles\Johnny Mnemonic.rec'

tableend?