RShell v0.01 – user guide
Contents
1. consider it like having a car and arbitrarily pulling out the brakes e MEM Provides some pee information on your organiser S memory Fer 3BBr2 bytes free 2 EFI ESI 2 LOC sh SUED SMEM Memory statistics Installed memory 2b2144 C z5B5EKb J 34368 33Kb Internal disc M 138528 13B5Ekb23 PEEP ZB8Kb dynamic Left SSD H Device is not present or nat responding Right SSD B Deuice is not present or not responding Expansion part C 131072 6 lzS8kb j 2239586 6 SIKb J MKDIR lt name gt Makes a new directory For an example picture refer to RmDir RESUME lt PID gt Resumes a task presumably marked as SUSPENDed without confirming RMDIR lt spec gt Removes the specified directory You cannot delete directories which contain files delete the files first 13592B bytes free TP d LOC sh SUED pgs PEPHET 135260 bytes frees Fl cE dz LOC M STERN Ju Thcfilms wurd Mampire urd Mirbris wrd Buas wrd Ideasz wrd HY STUFF 11 objects listed 18 files 34691 butesj and 1 directory 135260 bytes frees Fia 2 EF JH Le HUE SUED jor ne viter HOTE you cannot remove a directory until it is empty Remove directory LOCIIhNssWEO mystuft sure uM Yes Directory removed SUSPEND lt PID gt Suspends a task without confirming This command follows the same rules as KILL Note that many tasks are normally 1n a suspended state due to the efficient multitasking TAS2. You are not permitted to release modified versions of this software without my permission You may however distribute the original provided that you are distributing an exact duplicate of that which is available from my website Please no poking in file_id diz and the like If you include this software on the likes of a compilation CD I would appreciate a gratis copy of that CD in return doesn t have to be a fancy copy just burn off a cheap CD R so long as it 1s readable it ll do This software is provided as is with no guarantees No liability will be accepted for any loss or damage howsoever caused You use this software entirely at your own risk There is no support offered on this software However generally I will endeavour to correct any issues raised if you send me a polite and descriptive email note my limited access to the Internet below This software 1s entirely my own work I wish to credit and give thanks to those people who have released on line the OPL documentation as well as the collection of OPL examples plus Psionics for the system calls documentation as well as brief by useful information on the kernel memory structures My organiser s specification My organiser 1s an Acorn PocketBook II This is essentially a rebadged 3a with slightly different software provided as standard Most things are the same however Word is called Write but it 1s Word in the task list and Agenda 1s called Schedule I
3. contents only though you can specify the optional 1 parameter to display a list with file size date etc Directories are displayed in CAPITALS while files are displayed with an Initial capital You can specify a file spec which may contain wildcards 1n order to restrict what 1s shown 1 e wrd to list only word processor documents Use for anything and for a single character Output will pause after every screenful waiting a key press Short form 14384 bytes frees AGN APP DAT OFL P Sco SCR SPR HER ULG HRD DPD Susttucl pdd Sustrpcs ima Screen pic 15 ob jects listed 3 files 2341 butezj and 1z directories Long form screen 1 C1i4648 bytes frees AGH BH D 1383 Hr B4 18 17 18 AFF E D 1953 67 64 18 17 16 DAT BH D 1333 BHr B4 10 17 48 OFL AH D 199537607 4 18 17 58 OPO AH D 1 533 Hr mHdi 18 13 12 SCO BH D 1i333 Hr B4 10 18 20 SCR BH D 13533 Hr BH4 18 13 24 SPR AH D 1 533 Hr mBd4 18 13 25 IDR BH D 1333 Hr B4 10 18 36 WILD BH D 13383 BHr H4 16 18 54 MED AH D 13533 Hr Bd4 18 13 56 PD BH Db z2HBb5 HS BHr 21 82 54 Systue ae reS M 195947093738 15 41 86 z5 SPAL t i OFL BH D 138383 nr mB4 18 17 53 OPO A b 1333 B B4 18 13 12 SCO BH D 1383 nr B4 10 18 26 SCR BH D 1383 nr B4 18 18 24 SPR DP 1333 BH B4 18 13 25 WOR BH D 1383 nr B4 18 18 38 WL BH D 1383 nr B4d 18 18
4. one with a pic extension The following assumptions are made Image 1 in the file is the black plane and image 2 1s the grey plane There is no requirement for the grey plane to exist These assumptions are valid for most created or extracted software 1cons usually placed in NOPD as well as for the Screen pic file If you view a pic file that 1s a sequence of single colour pictures things may look a bit peculiar You cannot view other images within the pic file This may fail on machines with low memory RShell does not normally use the grey plane It 1s switched on prior to viewing a picture If there 1s insufficient memory you cannot view pictures and a No system memory message will briefly appear at the bottom right of the screen Output will pause awaiting a key press after displaying the picture Ls RShell m Press SPACE to continue In comparison with the existing Shell I have tried to avoid doing things that software built into the organiser can do perfectly well already For example there 1s no command to play sound files as Record can record and play perfectly well Here on the right you can see RShell installed on the Desktop ume Rohell Diary on nei Record Phonebk Firbriz Spell Thcfilms LJorid Vampire Memoryused 73K E z Free 33K Licence This software and source are copyright 2006 Rick Murray You may freely use this software provided that all copyright attributions are preserved
5. ve renamed the default file to call 1t Diary anyway that sort of thing The system memory is a mere 256K which has all too quickly reached a state of being mostly full slightly alleviated once a friend loaned me a 128K SRAM SSD I live in France so the default time zone 1s CET UTC 1 Winter or 2 Summer not that this should matter My preferred time format is 24hr date is Y Y Y YlMM DD Numbers are in the format 12 345 67 Again this shouldn t matter Contact details Email heyrick1973 at yahoo dot co dot uk Please note that I am only usually able to access the internet for half an hour a week at my local library so my responses will not be be as quick as I d like Website http www heyrick co uk software pb2 Thank you to mom John amp Irene Fr d rique Anne Francoise B Sandrine Francoise Tiphaine Bob amp Barbara Glenn Ewen Psionics Google and various Series 3a data repositories still around a decade later Music supplied by Classic FM TV SkyDigital 359 including Catherine Jenkins Triniti Hayley Westenra Andrea Bocelli Adiemus Lara St John Bond Enya Amici Forever Ennio Morricone and some others both good and horribly screechy Evidently I m now one of 9 million people figure from the channel s own promo advert who probably find most of CFMTV s output to be a heck of a lot more restful than that so called music they broadcast on ChartShow TV SkyDigital 355 Right no
6. 54 MED A D 138383 nr mB4 18 18 55 OPE BH D 2666 08 7867 21 88 54 Suzf tucl pdd res M 1994 69 38 16 41 86 sustrpcs ima ariz M 1336 18 38 11 22 38 Screen pic 16892 M 28856485411 21 12 35 15 ob jects listed 3 files 71372 butezs j and 1z directories t 1E8956 bytes freed ATTRIB lt file gt A A M M H H R R S S Files can have four attributions A Archive has it been modified M Same as A but in Psion parlance the Archive bit is a DOSism H Hidden file is not displayed in the Desktop System screen R Read only file can neither be updated nor deleted S System doesn t seem to have any special significance You can set attributes by prefixing the attribute letter with a and unset them by prefixing You may set multiple flags at one time 1 e A R but note that behaviour is undefined if you set conflicting flags like A M or S S S S etc Entering no attributes will report the current ones 15H35 butes free Fla hib LOC p 7 PPIETZIS Suet epee img SUstrpcs img f Fla ee eR 12944 bytes free L C M75 sattrib ET img th m r 5 Sustrpcs img EHS Fla Hebe 11 a 12944 bytes free LOC Mi attrib PDT img ta h rF Sustrpcz ima HM BATT lt type gt Displays information on the battery power supply If you specify the optional type parameter then you can set how the org
7. KS This lists the tasks eel on your organiser and displays information on them E FHEERZEEER 1327605 bytes frees Fl ZHHhber Hg LOC fin tasks On the left is the process name 1 STSEMULL H1 1138 C amp 4P2 suspended RAM code Inactive z SYSMANG t02 1766 amp 4BBH suspended RAM code Inactive 23 SYSFSEY Fas 1762 L amp 4EE suspended RAM code Inactive d SYS SEY Fod 1324 520 waitinaL51 FAM code Inactive a STSESHLL f 85 1386 C amp S6A waitinaL51 FAM code Inactive B amp B TIME 66 1445 L L amp 5H81 ready FROM code Active r LIMHK B87 21998 C amp SE6 ready ROM code Inactive B SYSEHCP SHE 1 356 624 suspended RAM code Inactive 3 SYS RFSY 69 22114 662 waiting S FAM code Inactive 16 SYS RPCS F 16 3358 CEBAB waiting S FAM code Inactive 11 RSHELL 11 22758 6DE suspended RAM code Inactive This 1s followed by the PID Program ID that you should use to refer to the task during SUSPEND RESUME or KL LL The following number in hex 1s the address of the task information block This 1s followed by the state of the task suspended waiting or ready This 1s followed by whether the application 1s executing code in RAM or ROM Finally if the application 1s active or inactive Due to the efficient multitasking you may well find that many tasks except Time are inactive and most likely suspended including RShell itself TYPE lt filespec gt This will display the file specifie
8. RShell vO O1 user guide Introduction While the software built into the PocketBook I Psion 3A is generally very good it falls down in instances when certain things need to be done for which there is no real support Two examples are dumping a file to see what is in it and basic file management There can be good reasons to want to dump a file Perhaps you wish to examine a file without loading it into something Or maybe there 1s simply no native support an example being the Screen pic file that is created when you press Ctr1 Shift Acorn S While you can press Tab from the Desktop to manage files you ll quickly find that renaming several files in a subdirectory can mean starting all over again for each file in other words Tab select directory select file press Acorn R wouldn t it have been so much better if the file manager hung around until you explicitly dismissed it Psion must have thought so too as the series 3C has a proper file manager built in Of course we must not lose track of the fact that these are power user options But then 1f you weren t a power user you probably wouldn t be reading this There is very little help built in to RShell This is intentional to further reduce memory requirements All of the screenshots within this documentation come from a real PocketBook II and not the 3A emulator They are from a very early version of the software and are not representative of the anticipated fi
9. aniser interprets the battery type alkaline 2 NiCad 600mAh 3 NiCad 1000mAh or NiMh 4 NiCad 500mAh riz944 bytes frees ria ZHHE LOC h E SEEN Battery status Main battery Currently Current worst Low Battery type MiCad C1866 mAs also use for Mihi Time on batt dh Sm Zzz 2UBEGSHr 23135 1Z Status im kor Low replace soon or plua in external adapters Lou Time inserted Backup batteru External supply Connected Time on ext 58h Bam Fils Total consumption 112 mAh CD lt dir gt Change to the directory specified which may be an absolute path CD LOC M APP or relative CD APP assuming you are currently in the root directory You can specify certain locations on the current device as follows Or specifies the parent directory N or specifies the root directory You must provide these special specifiers on their own therefore the following is valid CD CD app but the following is not valid CD 12848 butes free 12944 bytes free 12944 bytes free e CLS Clears the screen COPY source dest This will copy the specified file Names can be relative or absolute You will be DIO if me copy would cause a file to be overwritten FEDES PSE 32365 bytes frees ria 2h ee 2 SE 32358 bytes free REM itis 5 cd Enc pui c uir B Fla Hh ERR 22328 bytes free REHM C EI EHI SCST TE SOF TUBRE PES 2zcopu bricks opa lociiminappbricks opa F
10. consumer is the VIEW command which will try to enable the grey plane for drawing into You may need upwards of 24K free for that Due to pre declared global variables and arrays the majority of RShell has low variance in memory consumption THE COMMANDS This will display brief information on the version of RShell that you are using followed by a list of commands supported t 13920 bytes free ria HHB HS LOC 2 2 ela This is E5hell vB mHl 2BmB5 mBS 113 The following onan are available about attrib batt cd cls copy jel delete dir dump enit help infa kill ls mem mkdir quit resume rmdir suspend tasks type Wer uleu H You cannot enter a command after the help for more specific help however you can enter a command that takes parameters without any parameters in order to be reminded what is expected of you Here is both in deno 12312 bytes freed Abbe 2 reside Coc dub AGN shelp COD Soarrg there is no help available for individual commands Those commands that take parameters will remind you of their suntas if you enter the command without specifying anu parameter szi Use HELF on its own for a list of commands available 129512 bytes frees ria Adb we EEE LOC p AGH gt copu Syntax Copy lt source gt lt dest gt 7 1 filespec DIR 7 1 filespec LS 7 1 filespec These commands list the contents of the current directory The default style 1s a listing of
11. d as ASCII text Unlike some programs namely the other Shell it will filter control codes so typing an OPA won t cause your organiser to freak out Output will pause awaiting a key press after every screenful EIS Aa zt FER Ci127rv5B bytes freed Loe AE S EI gt type ibeitins weed eG s sewed DT D D T D 4 T C D DT D D T C D D utr A r A33 pep M MEN UJ TBI WWD ee LP P BTEod tenta amd k GTIUTTETEP Susa RC aaa a dace aba hat m js PM re aaa DM FPF HHHeadina H o M ea es ese ea er eee a ba ered sw tase ES aera ee D walixsR Rx ae F HEHeadina B IT S oa PE er RE ia sca dba Para ed ea ware ee sawilaa aoa aro F BLBu ulleted Lists ei2259x dzecslis9s E iu d ds dd r zaalwcal mw SR FEN MMMormal eecttitt RR under lin EBBold jj J wwesscokxxW RU IIIta alic c annnm Ceu a A SocHbesckrpi xxu Sede earn JLU VER S LANE 7218 We start out with a young girl accompanying her father to the scene of a c rime the murder of her mother and her mother s laouser Skip forward several yea re the girl is a duce The eee killer breaks out from prison and it look P m AL PL P VER Displays the OS and ROM versions Fla a E i3rrB bytes free LOC SEM SnD n Sr OS version E hM version EShell vers Sach S re 1 38 final Hal 2066 88 11 VIEW lt filespec gt This will display the specified bitmap file 1 e
12. ile copied from REM C i REICKMISC HLUHISITE SOFTUHEE FEZ bricks opa to loc m t app bricks opa DEL lt filespec gt Delete the specified file You will be prompted before actually deleting Note that you cannot use this command to delete directories use RmDir for that DUMP lt filespec gt This will dump the file specified in hex and ASCII the layout being familiar to anybody who has used a debugger Output will pause awaiting a key press after every screenful Flas HMB HEFER 12317 butes free LOC 1f AGN durmp diarg aan HaHa 41 Er 65 BE 64 61 46 69 BC 63 34 73 vB BS ZA B HaendaFileTupe BERIH BF 16 28 BB Hd mna BE ds BE Bd BB dB BE HA Bd BB I 1 1 ce BBaBHoB 2A 50 FF BB 54 EF 2D E4 EF 20 BC 69 73 74 BB BB To do list BREESE BE BE H Ba Be Be El BA ES B1 BB 54 ms ag 1C B2 BalissTssas Banda gi BS Bm BE Hh Be Be add HA B BB BB IF iB 31 33 wid BERSH 38 H4 IH 44 1E HB BH 15 4C 69 rH FA 69 B5 28 4D 8 D Lizzie M HHHH E3 4 75 B3 r2 B5 28 Z8 42 42 43 31 23 BE 58 Bl cBuire CBBCL F Hara BE SC 34 Bi GE dd 4C Ba BB BE IF 16 31 34 1C H2 i4 L 14 BEBSH 1E 45 B4 Be Bl 15 45 BE 56 BF 6C 2B 2D 28 46 2 E4 Envol Fr BBaBgB 65 GE 63 EB 2B 63 EF 75 72 73 65 1A 18 34 34 48 ench course 44H BEAR BS 1E 8S2 96 BB Hl 16 435 BE 56 BF BC 28 BC 2 S2 EnvVol 176 BERBER BS 2 69 r4 r5 r2 B5 28 18H SB 34 2H BS 1v 41 3C fF cr
13. iture 5dq5 H e EXIT QUIT Close down RShell If you think you may need it again later remember that your organiser multitasks so you can use the application keys underneath the screen to switch to a different task and come back to RShell later e INFO spec If the object specified is a file this will display information on the file File size attributes modification time If the object specified is parsed as a device 1 e no this will display device information Device type total free space battery status etc Info on a file Info on a device Fla 4Hbb He CEB 153223 bytes free IEICE a ols izrzB8 bytes free LOC Est NS info icr ins wed LOC p 2 ate a Information on LOC S s sWRO THCFILMS UED Information on i ues m Object name L Cc WM bWEgD Thcfilms wurd Deuice type RAM Ob ject type File Properties formattable zuztem internal dunamicallu zizeable Ob ject size S566 bytes Removeable Mo Is Read Only Mo Capacity 113152 bytes Is Hidden Mo Free space H bytes Is Sustem Mo Volume name Is Modified Yes Battery Status is not available Date stamp 2Bd5 Bo 1B8 Bi 3 14 KILL lt PID gt This kills off the task specified without confirming It is always better to try to exit a task cleanly You are not permitted to kill the system tasks or any task with a S in the first part of the task name because doing so will invariably mess up the functioning of your organiser
14. n optional parameter Example MyCmnd filename lt format gt This specifies a command MyCmnd that requires a filename as its first parameter The second parameter is a format specifier and it 1s optional therefore both of the following examples would be valid MyCmnd MMyFile dat MyCmnd MMyFile dat DATA If you see a vertical bar that means OR MyCmnd ONE TWO MyCmnd ONE TWO In the first example you must specify one or two The second example is the same except that the choices are optional you can specify nothing The documentation will tell you what information you are supposed to provide If you get stuck typing will provide a list of commands while typing the command without any of its parameters will remind you what the correct syntax 1s unless of course the command has an action upon no parameters in which case it will perform that action 1 e VER will display version information When you are expected to enter file specifiers wild cards are generally not accepted If you have less than 8K free memory you will see a warning to this effect before the time and date If you have less than 3K free memory you will instead be informed that RShe cannot continue and that you should free up some memory and then press Y In the latter case you can often continue it depends on what you wish to do however if RShell aborts due to lack of memory you were warned The main memory
15. nal state of the software This user guide was originally written in Write on my 3A mostly while in the car and later converted to a DTP form with OvationPro Data security Several commands have the potential to cause data loss either by deleting files or by killing errant tasks You are prompted to confirm your action if you are deleting files A red P marks commands to be careful with RShell absolutely will not allow you to kill off the background system tasks There is no hidden option to do such a thing as well it d be a really stupid idea The prompt When you first start R Shell you will see Welcome to E5hel11 version 0 01 zBBgdb5 B3 117 Enter HELP for a list of commands available 13920 bytes free H5Shell 2446 Rick Murray This is a brief welcome message followed by the prompt The top line of the prompt shows the current date and time followed by the amount memory that is available The lower line shows the current path followed by a gt DOS like At the prompt just enter your commands I m sure you ve all used a command line before be it RISC OS or DOS or some flavour of Unix The text size 1s necessarily small due to the need to squeeze as much as possible into a limited screen Using this text size allows up to 80 columns by 17 rows Shell commands Please note the following syntax lt something gt This denotes a parameter that is passed to the command anything This denotes a
16. w as I write this CSTV is playing God This Hurts by Betty Curse and what is she wearing that s weirder than Kelly Osbourne s normal attire while CFMTV is playing Enya s Amarantine Nuff said really end 2006 08 08 02 40 CET updated 2008 06 12 20 50 CET
Download Pdf Manuals
Related Search