· How do I access the built in FTP server, and what can I do with it?
(Entry last updated on February 18th, 2014)
The Hijack kernel includes KFTPD, a kernel based FTP server. Simply point your favorite FTP client to the IP address of your empeg/RioCar, and login. You will automatically be logged in as root, and no login or password are required. You can browse the directories at will. You can also issue SITE commands, as you'll see below.
NOTE: By default, the Hijack FTP and HTTP servers only run when the player is in AC/HOME mode. If you are having trouble accessing these features, check to make sure the player isn't in DC/CAR mode.
Since the hard drives are mounted Read Only (RO) on bootup, you won't be able to upload/write to the drives until you issue a Readable/Writeable (RW) command. Here's a sample session using a command line client:
Note the RO command at the end of the session. Don't forget to remount your drives Read Only before you logout or you could mess stuff up (descriptive i know... details forthcoming).
ftp xx.xx.xx.xx <----- player's IP address or DNS hostname
user: (hit enter)
password: (hit enter, unless you have set up a password)
site chmod 0755 executablefile
Different FTP clients issue commands in different ways. Here's a quick breakdown on some of the most popular FTP clients:
SITE commands need to be prefixed by either "literal" or "quote".
For example, a (useless) session might look like this:
ftp> open 192.168.1.10
ftp> login: [enter]
ftp> password: [enter]
ftp> LITERAL SITE RW
ftp> LITERAL SITE RO
(LITERAL can be substituted with QUOTE if desired)
You have to create a Custom Command with CuteFTP, as follows:
1. Select Commands -> Custom Commands -> Define from the menu bar.
The commands will be saved and you can access them with the menus or the hot key you set up.
2. Type a name identifier in the Label field, we'll do "RW" for an example.
3. Enter the command text in the Command Text field, which would be "SITE RW".
4. Enter an optional hot key in the Hot Key field. The command can be executed using Control+Shift plus this hot key.
5. Click the Add button.
After you are logged in, right click in the Remote Site window, select FTP Commands -> SITE, and type the command (i.e. RW, RO, etc) and click [OK].
Most FTP clients have the ability to issue commands, so poke around if your client isn't shown here. If sending plain SITE commands don't work, try prefixing it with QUOTE or LITERAL. Or you could always read the client's help file. =D
Here's a list of the ftp commands Hijack utilizes with descriptions:
Multiple SITE commands can be issued at once, separated by semi-colons.
Remounts /, /drive0, /drive1 for Read-Write access.
Remounts all RW mounted drives to Read Only access.
SITE CHMOD 0755 executablefile
Standard Change Mode command to alter file permissions.
Reboots player, but issues SITE RO before doing so.
SITE POPUP 10 This is a popup message.
Displays a timed message on the display.
Format is: SITE POPUP [timeInSeconds] [message]
This is useful for userland apps to display messages easily.
SITE BUTTON Play
SITE BUTTON 20DF14.L
Issues remote button commands. Works with .L modifier for Long presses.
Displays the list of SITE commands that Hijack understands... which should be all the ones listed here.
You can use FTP to update the kernal, which is described in the FTP section of the "How do I install Hijack" FAQ entry.
For FTP configuration options, check out the kftpd_control_port, kftpd_data_port, kftpd_password, and kftpd_verbose commands in the config.ini FAQ entry.