How to Configure FoxyRoxy and The Scripts

An overview of FoxyRoxyLinux

How to Configure FoxyRoxy and The Scripts

Postby jbv » Sun Aug 12, 2012 12:15 pm

Configuring the System and the Helper Scripts

FoxyRoxy contains script files to help make changes to the sqf's
As a rule of thumb, all scripts live in /scripts which is in the path. Script names will usually start with the number that the script belongs to. For example 01-load will load 01-FoxyRoxy.squashfs into the designated work area
The script files use the following architecture when looking for files and when creating or writing files.

There are 3 environment variables that most scripts use.
These environment variables are set in /etc/profile which is executed during startup.

SQF_SRC = The Source Directory.
This is where the sqf files live
default = /live/image/live (usually a USB stick)

SQF_WRK = The Working Directory.
This is where the sqf will be unpacked
default = /tmp (the system RAM drive)

SQF_TMP = The Temporary Directory.
This is where the sqf will be squashed before saving back to the Source Directory
default = /tmp (the system RAM drive)

If your machine has 2Gb or more of RAM, then leaving the WRK and TMP directories in RAM should be fine. If you have less RAM, or your sqfs live on a hard drive, you may need to re-configure these variable before making any changes. It is very important that the SQF_WRK is not a FAT32 format. FAT32 does not know about Linux file permissions and can also have trouble with linux symlinks. If you try to use a FAT32 drive as your SQF_WRK directory, you will have trouble. For safety, it is suggested that SQF_TMP not be FAT32 either.

There is a special script to patch these variables and it must be run in a special mode, called "source mode". The script is 99-setdirs and to run it you should be in a terminal session and type "source 99-setdirs [enter]" After giving you various warnings the script will show you the current settings and prompt you to enter the new directories for each of the 3 sections. It will then use the directories you entered to load FoxyRoxy into the working directory, patch /etc/profile with the directories you entered and create a new 01-FoxyRoxy.squashfs in the Temporary Directory before making a backup of the original 01-FoxyRoxy.squashfs and saving the new 01-FoxyRoxy.squashfs

If you need to make any changes to the 3 directories just mentioned, this should be the first script you run. As your changes are written back to the source drive, you will only need to do this once.

International Keyboard Support

FoxyRoxy supports International and special Keyboards as supported by Debian Linux. The script 99-setkeys will run the Keybaord Reconfiguration utility where you can select your keyboard. When finished, you will be prompted to run 99-savekeys which will then patch FoxyRoxy or FoxyDesktop to save your changes.

Sound

FoxyRoxy provides support for most embedded Audio chipsets.
The latest build of the ALSA (linux sound) drivers are included as standard.

To test the audio, simply type "aplay test.wav" at a console prompt while in the "root" directory.
jbv
 
Posts: 600
Joined: Sat Jul 14, 2012 2:02 am
Location: Sydney, Australia

More Scripts

Postby jbv » Sun Aug 12, 2012 12:19 pm

---[ General Scripts ]---
netinfo = Display Network Configuration
showpaper = Display image in ~/papers (using fbv)

fbt image.ext = starts Frame Buffer Terminal with specified background wallpaper
--->image.ext is the name of the paper from ~/papers
fbt without a paper will load a default wallpaper
Do not try to execute fbt from inside of X as this has not been tested and will most likely do horrible things.

mount-usb0 = mounts usb stick on /dev/sda1 to /media/usb0 (assumes vfat filesystem)
mount-usb1 = mounts usb stick on /dev/sda1 to /media/usb1 (assumes vfat filesystem)
mount-all = mounts all sticks and hard-drives with all filesystems
unmount-all = unmounts all sticks and hard-drives

ps-mem.py = shows true memory usage of a program
ps-mem.py | grep "program name" will show individual program details

There are multiple xx-load and xx-save scripts to maniupliate the .squashfs files
All scripts show what is going to occur and prompt before execution
All scripts that overwrite a .squashfs rename the existing file to .sqfback

95-create = creates the "save file" 95-snap.squashfs using /live/cow
95-delete = deletes the "save file" from usb/disk
95-refresh = loads 95-snap, copies current /live/cow then saves it
95-load = Loads 95-snap.squashfs so that you can "tweak/clean" it
95-save = Saves 95-snap.squashfs after "tweaking/cleaning"

---[ Special Scripts ]---

99-zapmans
- This script will remove all man and doc files from a "working sqf" directory.
- You should use it after using a xx-load script
- You must use the full path name to the working directory.
- For example. you would type: 99-zapmans /tmp/sqf-name

---[Parked Scripts]---

These scripts have been parked as things still need to be done to or with them.

/scripts/parked/mount-qnap = mounts a NFS resource to /media/qnap
/scripts/parked/umount-qnap = unmounts the /media/qnap resource
jbv
 
Posts: 600
Joined: Sat Jul 14, 2012 2:02 am
Location: Sydney, Australia


Return to The Basics - Please Look in here First



Who is online

Users browsing this forum: No registered users and 1 guest

cron