Download - Aros Shell Manual 0.80
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 1/92
AROS Shell Manual
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 2/92
AROS PUBLIC LICENSE (APL)
You may obtain a copy of the License athttp!!"""#a$os#o$%!&icense#htm&
'ISCLAIER O *ARRAN+Y#
CO,ERE' CO'E IS PRO,I'E' UN'ER +-IS LICENSE ON AN .AS IS/ BASIS0 *I+-OU+ *ARRAN+Y O ANY 1IN'0 EI+-ER E2PRESSE' OR IPLIE'0 INCLU'IN30 *I+-OU+ LII+A+ION0 *ARRAN+IES +-A+ +-ECO,ERE' CO'E IS REE O 'EEC+S0 ERC-AN+ABLE0 I+ OR A PAR+ICULAR PURPOSE OR NON4INRIN3IN3# +-E EN+IRE RIS1 AS +O +-E 5UALI+Y AN' PERORANCE O +-E CO,ERE' CO'E IS *I+-
YOU# S-OUL' ANY CO,ERE' CO'E PRO,E 'EEC+I,E IN ANY RESPEC+0 YOU (NO+ +-E INI+IAL'E,ELOPER OR ANY O+-ER CON+RIBU+OR) ASSUE +-E COS+ O ANY NECESSARY SER,ICIN30 REPAIROR CORREC+ION# +-IS 'ISCLAIER O *ARRAN+Y CONS+I+U+ES AN ESSEN+IAL PAR+ O +-IS LICENSE#NO USE O ANY CO,ERE' CO'E IS AU+-ORI6E' -EREUN'ER E2CEP+ UN'ER +-IS 'ISCLAIER#
LII+A+ION O LIABILI+Y#
UN'ER NO CIRCUS+ANCES AN' UN'ER NO LE3AL +-EORY0 *-E+-ER +OR+ (INCLU'IN3NE3LI3ENCE)0 CON+RAC+0 OR O+-ER*ISE0 S-ALL YOU0 +-E INI+IAL 'E,ELOPER0 ANY O+-ERCON+RIBU+OR0 OR ANY 'IS+RIBU+OR O CO,ERE' CO'E0 OR ANY SUPPLIER O ANY O SUC- PAR+IES0BE LIABLE +O ANY PERSON OR ANY IN'IREC+0 SPECIAL0 INCI'EN+AL0 OR CONSE5UEN+IAL 'AA3ES O
ANY C-ARAC+ER INCLU'IN30 *I+-OU+ LII+A+ION0 'AA3ES OR LOSS O 3OO'*ILL0 *OR1S+OPPA3E0 COPU+ER AILURE OR ALUNC+ION0 OR ANY AN' ALL O+-ER COERCIAL 'AA3ES ORLOSSES0 E,EN I SUC- PAR+Y S-ALL -A,E BEEN INORE' O +-E POSSIBILI+Y O SUC- 'AA3ES#+-IS LII+A+ION O LIABILI+Y S-ALL NO+ APPLY +O LIABILI+Y OR 'EA+- OR PERSONAL IN7URYRESUL+IN3 RO SUC- PAR+Y8S NE3LI3ENCE +O +-E E2+EN+ APPLICABLE LA* PRO-IBI+S SUC-LII+A+ION# SOE 7URIS'IC+IONS 'O NO+ ALLO* +-E E2CLUSION OR LII+A+ION O INCI'EN+AL ORCONSE5UEN+IAL 'AA3ES0 SO +-IS E2CLUSION AN' LII+A+ION AY NO+ APPLY +O YOU#
COPYRI3-+ AN' +RA'EAR1S#Copy$i%ht 9 :;;<4=>>?0 +he AROS 'e@e&opment +eam# A&& $i%hts $ese$@e#
Ami%a is a t$aema$ of Ami%a Inc# A&& othe$ t$aema$s be&on% to thei$ $especti@e o"ne$s#+he AROS 1itty mascot is 9 =>>D by E$ic Sch"a$t
+he ima%e use in the co@e$ is 9 =>>< by 'ami$ SiFao@ic#
+his manua& "as p$ouce usin% a @a$iety of $esou$ces an ocumentation a@ai&ab&e in """#a$os#o$% anothe$ AROS $esou$ce sites by 7oGo Ra&ha0 Pete$ -utchison an Pao&o Besse$#O$i%ina& ocumentation "$itten by atthias Rust&e$#Poseion commans an uti&ities ocumentation by Ch$is -o%es#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 3/92
TABLE OF CONTENTS
WELCOME............................................................................................................6DOCUMENTATION CONVENTIONS.............................................................................6
OTHER USEFUL OR REFERENCE DOCUMENTATION........................................................7
.......................................................................................................7
INTRODUCTION..............................................................................8
FEATURES............................................................................................................8W ARNING............................................................................................................9
CHAPTER 1: AROS SHELL BASICS...................................................10
AROS SHELL.......................................................................................................10P ATH..................................................................................................................11COMMAND TEMPLATE.............................................................................................12
P ATTERNS............................................................................................................13R EDIRECTION.......................................................................................................13PIPE...................................................................................................................13SPECIAL DEVICES..................................................................................................13R UNNING IN BACGROUND.....................................................................................1!B ASIC FILE OPERATION WITH SHELL:.......................................................................1!
C$eatin% a i$ecto$y###############################################################################################:H 'e&etin% a fi&e#######################################################################################################:H
WORING WITH SMART FILE S "STEM #SFS$.............................................................1%SS case4sensiti@e fi&enames##################################################################################:< Une&ete fi&es########################################################################################################:< inin% you$ is space########################################################################################:
SCRIPT PROGRAMMING.................................................................17 AROS&DOS SCRIPTING........................................................................................17WORING WITH A SCRIPT FILE...............................................................................17
Eitin%##################################################################################################################:? EJecutin% f$om she&&##############################################################################################:K EJecutin% f$om "ane$e$#######################################################################################:K Comman type eJecution####################################################################################:K
CHANGING S"STEM SCRIPT FILES.............................................................................18
AROS COMMAND REFERENCE.........................................................20
AAuiooes####################################################################################################== ABuffe$s############################################################################################################== A'atatypes#######################################################################################################=D AUSBC&asses#####################################################################################################=D AUSB-a$"a$e##################################################################################################=D A&ias#####################################################################################################################=H As######################################################################################################################=< Assi%n##################################################################################################################=< A@ai&#####################################################################################################################= Beep####################################################################################################################= Bin'$i@e$s###########################################################################################################=? B$ea###################################################################################################################=? C'#######################################################################################################################=K Chan%e+asP$i######################################################################################################=K
C&ip######################################################################################################################=;
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 4/92
Conc&ip#################################################################################################################D> Copy####################################################################################################################D> Copy+oPAR###########################################################################################################DD Cut#######################################################################################################################DD 'ate#####################################################################################################################DH 'ebu%##################################################################################################################D<
'eco$ation############################################################################################################D< 'e&ay###################################################################################################################D< 'e&ete##################################################################################################################D 'e@List#################################################################################################################D 'i$#######################################################################################################################D? 'ischan%e###########################################################################################################D? Echo#####################################################################################################################DK Echo#####################################################################################################################DK EFect####################################################################################################################DK E&se######################################################################################################################D; Enc&i ! EnShe&&###################################################################################################D; Enif####################################################################################################################D;
Ensip################################################################################################################H> E@a&######################################################################################################################H> EJecute################################################################################################################H:ai&at####################################################################################################################H:au&t####################################################################################################################H= i&enote################################################################################################################HD o$mat#################################################################################################################HD 3et#######################################################################################################################HH 3eten@#################################################################################################################H< 3fJCont$o&############################################################################################################H< 3u$u####################################################################################################################H< IconJ####################################################################################################################H
Ientify################################################################################################################H If#########################################################################################################################H? Info######################################################################################################################HK Ip$efs###################################################################################################################HK Insta&&###################################################################################################################H; Insta&&4%$ub=4iDK4pc#############################################################################################H; Insta&&4iDK4pc (no" ep$ecate)#########################################################################<> 7oin######################################################################################################################<> Lab######################################################################################################################<:LibList##################################################################################################################<:List#######################################################################################################################<= Loa#####################################################################################################################<D Loa$esou$ce########################################################################################################<D
Loc#####################################################################################################################<H aei$################################################################################################################<< ae&in###############################################################################################################<< ount##################################################################################################################< Ne"she&&###############################################################################################################< Open####################################################################################################################<? Pa$tition###############################################################################################################<K Path#####################################################################################################################<; PathPa$t###############################################################################################################> Pipe#####################################################################################################################:P&ay######################################################################################################################:P$ompt#################################################################################################################=
P$otect#################################################################################################################=
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 5/92
Ps'e@Liste$#########################################################################################################D PsE$$o$Lo% #########################################################################################################H PsStacLoae$#####################################################################################################H 5uit######################################################################################################################H 5uita$os###############################################################################################################< Reboot#################################################################################################################<
Re&abe&#################################################################################################################< Rename################################################################################################################ ReMuestChoice###################################################################################################### ReMuesti&e###########################################################################################################? ReMuestSt$in%#######################################################################################################K Resient###############################################################################################################K ResList#################################################################################################################; Run######################################################################################################################; Sea$ch##################################################################################################################?> Set#######################################################################################################################?> Setcache##############################################################################################################?:SetC&oc###############################################################################################################?=
Set'efau&tont######################################################################################################?= Set'ate################################################################################################################?D Seten@##################################################################################################################?D Set1eyboa$#########################################################################################################?H She&&#####################################################################################################################?H SSfo$mat############################################################################################################?< SSMue$y##############################################################################################################?< Shuto"n#############################################################################################################? Sip######################################################################################################################? So$t######################################################################################################################?? Stac####################################################################################################################?? Status##################################################################################################################?K
+ype####################################################################################################################?K Una&ias#################################################################################################################?; Unpac#################################################################################################################?; Unset###################################################################################################################K> Unseten@##############################################################################################################K> Un6ip###################################################################################################################K:,e$sion#################################################################################################################K= *ait#####################################################################################################################K= *ait2###################################################################################################################KD *hich###################################################################################################################KD *hy#####################################################################################################################KH
POSEIDON USB DEVICES UTILITIES...............................................8%
'Raio+oo&###########################################################################################################K< Pencam+oo& #########################################################################################################K< Po"an+oo& ########################################################################################################K? Rocet+oo& ##########################################################################################################KK
APENDI' I ( PRINTER ESCAPE SE)UENCES #OR COMMANDS$... ...89
APPENDI' II ( AROS&DOS ERROR MESSAGES................................90
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 6/92
HOW TO USE THIS MANUAL
W*+,-*
+his is manua& is meant to %et peop&e use to AROS4'OS# It is fo$e@e$yboy inte$este in AROS0 as it t$ies to p$o@ie info$mation on AROSin iffe$ent &e@e&s of eJpe$tise# *e&& t$y to co@e$ e@e$ythin% in epth0 butin such a "ay that you on8t nee to &ea$n "hat you on8t "ant to &ea$n#
It t$ies to co@e$ mu&tip&e p&atfo$m usa%e0 "ith the eJception of AA (AROSfo$ Ami%a) a&thou%h many issues co@e$e he$e shou& app&y#
i$st chapte$s on this manua& a$e fo$ you to %et the han%s on the usa%e ofthe AROS she&& they co@e$ most basic an essentia& aspects of ai&y usa%eof the She&& an AROS4'OS commans#Late$ chapte$s a$e intene most&y fo$ sc$ipt p$o%$ammin% an consu&tpu$pose#
If you$e fami&ia$ "ith Ami%a an Ami%a'OS itse&f0 most of the subFectco@e$e he$e shou& not be no@e&ty to you0 but the$es a &ot of soft"a$especific subFects that a$e ea&t he$e that mi%ht be of use to you#
D-,/*- C-4*-5
+he fo&&o"in% con@entions a$e use th$ou%h out this manua&
1EY*OR'S 1ey"o$s a$e isp&aye in a&&uppe$case &ette$s0 ho"e@e$0 thea$%uments a$e not case sensiti@e(un&ess state othe$"ise)#
nQ An%&e b$acets enc&ose @a$iab&einfo$mation that the use$ shou&a$ess#
Courier +eJt appea$in% in Cou$ie$ font(b&ac co&ou$) $ep$esents
info$mation isp&aye on AROSsc$een
Courier +eJt appea$in% in Cou$ie$ font (b&ueco&ou$) $ep$esents info$mationisp&aye on host OS sc$een
1ey:1ey= 1ey combinations isp&aye "ith a (p&us) si%n connectin% theminicate that p$essin% the eyssimu&taneous&y fo$ a %i@in% actiono$ p$oceu$e#
D -/ -+his ima%e $e%a$s somemo$e cu$ious aspect of AROS itse&f o$ $e&atesubFect#
W;<:+his in of ima%e isintene to %et you$
attention $e%a$in% somep$oceu$e o$ beha@iou$"hich mi%ht $eMui$ecaution f$om you$ pa$t#
NOTE:+his ima%e $e%a$ssomethin% that you shou&
no" in o$e$ to pe$fo$man ope$ation on the bestpossib&e manne$#
E=>+*?T/-;++his une$&ines aneJamp&e of an inte%$ateo$ comp&eJ ope$ationpe$fo$me une$ AROS#
H;;* ;*+*:It pinpoints someimpo$tant points $e%a$in%ha$"a$e suppo$t0beha@iou$ o$ confi%u$ation#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 7/92
Notice the sie of this pa%e it has some ima%e "ith iffe$ent pu$poses# +he pu$poses a$ei&&ust$ate an esc$ibe on that pa%e#
A&so on the sie of the pa%e mi%ht be the Icon p$o%$am that the eJce$pt nea$ it $efe$s to0
basica&&y it acts as Muic $efe$ence#
O@*; /5*/+ -; ;**;*,* -,/*-
You shou& a&so $ea the fo&&o"in% manua&s AROS Use$ anua& AROS Insta&&ation anua&
A&so its $ecommene that you $ea othe$ mo$e acti@e&y maintaine ocumentation0 "hich
is ept in http!!"""#a$os#o$%!#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 8/92
INTRODUCTION
AROS4'OS featu$es a CLI (Comman Line Inte$face) "hich sha$es thesame a@anta%es an usa%e of the Ami%a'OS one#
An &ie Ami%a'OS it combines a&& the best aspects of UniJ an 'OSComman Line Inte$faces0 "ith some eJc&usi@e cha$acte$istics#ost of the commans a$e une$stanab&e at fi$st $eain%0 as "e&& as theoptions passe as a$%uments#
.An sti&& it p$o@ies con@entions fo$ han&in% a$%uments0 an especia&&yoptions0 that $amatica&&y inc$ease ease4of4use# It p$o@ies a comp&etesc$iptin% en@i$onment that is so "e&& inte%$ate that sc$ipts a$einistin%uishab&e f$om bui&t4in commans 4 a&& the suppo$tin% functiona&ityfo$ bui&t4in commans become instant&y an fu&&y a@ai&ab&e fo$ a sc$ipt0 ana sc$ipt can be use e@e$y"he$e an in e@e$y "ay that a bui&t4in
comman can be# *$itin% sc$ipts fo$ Ami%a'OS (AROS4'OS) is a Foy0 anthe $esu&ts a$e usab&e0 $eaab&e0 an maintainab&e#
u$the$mo$e0 Ami%a'OS p$o@ies an e&e%ant means of mana%in% p$o%$amconfi%u$ation# Each sho$tcut icon in the 3UI can in@oe a p$o%$am0optiona&&y "ith a ocument fi&e# Nothin% ne" the$e# But each icon can beeasi&y confi%u$e to c$eate a custom p$o%$am en@i$onment usin% simp&ename!@a&ue pai$s simi&a$ to 7a@a p$ope$ty fi&es an *ino"s INI fi&es#+he$e a$e no cent$a&ie $e%ist$ies o$ confi%u$ation atabases0 yet it isimmense&y usab&e#/ (*i&&iams Robe$t '#)
So as you can see0 AROS4'OS may p&ay an impo$tant pa$t in you$ "o$# An mi%ht Fust offe$ the necessa$y commans to comp&ete you$ "o$ T"hethe$ is simp&e o$ comp&eJ fi&e mana%ement0 net"o$ suppo$t0 sc$iptp$o%$ammin% you mi%ht fin that AROS4'OS oes the Fob in anhansome manne$#
F*/;*5 AROS She&& featu$es the fo&&o"in% aspects
- Imp&icit chan%e i$ecto$y (C)
- Comman eJecution histo$y- Comp&etion he&p- Simp&e fi&e matchin% (Case unsensiti@e)- ,e$sati&e patte$n matchin%- Soft&inin% an -a$&inin% of fi&es- u&tip&e sessions (can ha@e iffe$ent bac%$oun p$ocesses)- Rei$ection an pipin% of comman input ! output- ost commans "o$ ac$oss iffe$ent fi&e4systems- Po"e$fu& sc$ipt p$o%$ammin%
D -/ - that Ami%aOS "as the fi$st p$e4empti@e mu&ti4tasin%ope$atin% system fo$ the .Pe$sona& Compute$/conceptV
Launche in :;K< the Ami%a:>>> spo$te the Ami%aOS"hich un&ie its :4bitcounte$pa$ts (IB pc0 App&eac an Ata$i st) "as a t$uep$e4empti@e mu&ti4tasin%ope$atin% system tain%
a@anta%e of the Custom Chipa$chitectu$e#
+he &atest Ami%aOS offe$in%u$in% the Commoo$e Ami%ae$a "as the D#: @e$sion in:;;D an offe$e a mo$estab&e an f&eJib&e OS thatenu$e fo$ many yea$s an%ot iffe$ent aitions# +his is$e%a$e as the main fact thatept Ami%a community acti@ee@en afte$ the Commoo$eemise#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 9/92
W;<
AROS is a&pha Mua&ity soft"a$e# +his means that it is cu$$ent&y
most&y fun to p&ay "ith an coo& to e@e&op fo$# If you camehe$e because you thou%ht AROS "as a finishe0 comp&ete anfu&&y usab&e ope$atin% system0 you "i&& most &ie&y beisappointe# AROS isn8t the$e yet0 but "e8$e s&o"&y mo@in% inthe $i%ht i$ection#
W;<:
REA' ABOU+ +-E AROSPUBLIC LICENSE (APL)
AN' 'ISCLAIER O*ARRAN+Y ON PA3E =#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 10/92
CHAPTER 1: AROS SHELL BASICS
AROS S@*++
AROS has a comman &ine inte$face0 the 8She&&8# You can sta$t it "ithmenu *ane$e$QShe&&# A "ino" "ith the path of the cu$$ent AROS"ino" "i&& be opene# +he p$ompt no$ma&&y sho"s the numbe$ of theShe&& an the cu$$ent path#
+he She&& has a comman histo$y# You can access commans "ith cu$so$up an o"n eys#
+he$e is a comp&etion featu$e# If you type the fi$st &ette$s of a commano$ a fi&e name an p$ess the tabu&ato$ ey0 the She&& sea$ches fo$ a
matchin% name# If the$e a$e mo$e possibi&ities a "ino" "i&& be opene"he$e you can se&ect an ent$y#
AROS commans an fi&e names a$e case insensiti@e# You can e@en usemiJe case#
AROS sea$ches commans in the cu$$ent i$ecto$y an in the sea$chpath# You can @ie" an chan%e the sea$ch path "ith the path comman#Some impo$tant commans
C' 44 chan%es i$ecto$y (not $ea&&y neee in AROS she&&) 'IR 44 sho"s content of i$ecto$y COPY 44 copies fi&es an i$ecto$ies 'ELE+E 44 e&etes fi&es an i$ecto$ies INO 44 sho"s a@ai&ab&e $i@es A1E'IR 44 c$eates i$ecto$y RENAE 44 $enames fi&es an i$ecto$ies +YPE 44 sho" content of teJt fi&e
#$ W;<: A&thou%h commans "i&&"o in a case insensiti@emanne$0 that mi%ht not bethe case fo$ some fi&e4systems othe$ than San A+#*hen "o$in% "ith UniJi&e4systems be a"a$e thatthey a$e case sensiti@e anmust be ea&tapp$op$iate&y#
A&so SS has a case4sensiti@e option possib&e toset on fo$mattin% thepa$tition0 if by some$eason you $eMui$e thata&so app&y case sensiti@ityto you$ commans#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 11/92
P@ A path is comp&ete esc$iption of the &ocation of a pa$ticu&a$ fi&e on a is e@ice# *hen ap$o%$am emans the name of a fi&e fo$ &oain%0 it "i&& specify the fi&es path0 inc&uin% the@o&ume o$ e@ice name an a&& the $a"e$s that &ea to the fi&e#
Abso&ute paths sta$t "ith the $i@e name an a co&on ()0 i$ecto$ies a$e sepa$ate "ith as&ash (!)# +he $i@e name can be a e@ice name (h>)0 a @o&ume name ("o$bench) o$ a&o%ica& $i@e (see assi%n comman)
EJamp&e dh0:dir1/dir2/file.dat
'o bea$ in min that the e@ice name an the @o&ume name a$e iffe$ent "ays ofientifyin% a %i@en is# o$ most pu$poses usin% eithe$ the name o$ the e@ice i "i&& %$antaccess to the same path (eithe$ f$om she&& o$ a fi&e4$eMuesto$)#o$ eJamp&e if you ha@e a C'4RO in e@ice c> (p$obab&y the fi$st C'4RO) "ith the
@o&ume name .y4C'/0 you can $efe$ence it as eithe$ .c>/ o$ .y4C'/# A&thou%h$efe$encin% as its @o&ume name "ith no C' p$esent in C' $i@e "i&& cause AROS to pop a$eMuesto$ asin% the use$ to inse$t the .y4C'/ in an a@ai&ab&e $i@e#
If you nee the cu$$ent path as a$%ument of a comman0 you can Fust "$ite #
EJamp&e copy from ram:x to ""
A co&on a&one means base i$ecto$y of the cu$$ent path# *hen the path sta$ts "ith a co&onthen it is $e&ati@e to the base i$ecto$y of the %i@en path#
A s&ash at the be%innin% of a path means %o one &e@e& up# +"o s&ashes mean %o t"o &e@e&sup an so on#
*hen a path contains spaces it must be "$itten "ithin oub&e Muote cha$acte$s#
EJamp&e type "name with spaces"
+he fo&&o"in% $u&es app&y fo$ AROS namin% of fi&es an $a"e$s
- Names can be up to D: cha$acte$s &on% in OS!S e@ices an :>? in S ! A+e@ices- Co&ons () an s&ashes (!) a$e not a&&o"e "ithin a name# +hese cha$acte$s a$e$ese$@e fo$ path statements#- Uppe$ an &o"e$ case iffe$ences (such as capita&iation) a$e p$ese$@e an isp&ayeby AROS# +he system oes not istin%uish the iffe$ence0 since it t$eats them in case4insensiti@e manne$ (uppe$ case an &o"e$ case a$e consie$e the same at inte$na& &e@e& ofthe OS)#- 'up&icate fi&e names a$e not a&&o"e "ithin the same $a"e$# If you sa@e a fi&e "iththe same name as an eJistin% fi&e in a $a"e$0 it o@e$"$ites the o$i%ina& fi&e in that $a"e$#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 12/92
- +he use of spaces must be han&e "ith caution0 since confusion mi%ht a$ise# A&so fo$she&& han&in% of space containin% names0 it must app&y commas(.) at the be%innin% anen of the fu&& path#
+he icons that *ane$e$ uses to $ep$esent the fi&es in a @o&ume o$ a $a"e$ a$e sto$e in
specia& #info fi&es0 "ith the name of the #info fi&e matchin% the name of the fi&e it $ep$esents#o$ eJamp&e0 the icon fo$ Ca&cu&ato$0 a simp&e ca&cu&ato$ too&s0 is foun in the fi&e
.Ca&cu&ato$#info/#
So a basic $a"e$!fi&e st$uctu$e mi%ht be somethin% &ie this
C- *>+*
A Muestion ma$ afte$ the comman sho"s the pa$amete$ temp&ate of the comman# +hecomman is then in a moe "he$e it "aits fo$ you to type in the pa$amete$s#
EJamp&e copy ?FR!/!#/$$%%/&'()*#/&+(F,+(FF*R/-/C%*/&$#*&/&R/&C!/&R*'/&
+he ey"o$s can ha@e options
!A 44 a$%ument must be %i@en !1 44 ey"o$ must be "$itten "hen usin% this a$%ument !S 44 s"itch Fust "$ite the ey"o$ to access the s"itch !N 44 nume$ica& a$%ument ! 44 mo$e than one a$%ument is possib&e ! 44 $est of comman &ineW 44 abb$e@iation you can optiona&&y use the abb$e@iation
*hen ca&&in% a comman 8W8 can be use fo$ istinct assi%nment bet"een ey"o$ an
@a&ue
'is
'ocuments+oo&s 'i$
Pictu$es
-o&&iay#Fp%Ch$istmas#Fp%
inancia& $epo$tPe$sona& notes
Cash4f&o" Repo$t
B$ochu$e
Eito$ -e&p
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 13/92
EJamp&e copy from,a.dat to,.dat
P*;5
Some commans a&&o" patte$ns fo$ fi&e name pa$amete$s
V 44 one a$bit$a$y cha$acte$XV 44 e$o o$ mo$e a$bit$a$y cha$acte$sXJ 44 e$o o$ mo$e J 44 ne%ationZ 44 o$() 44 %$oup[\ 44 $an%e
EJamp&es
dir ?.infodir ?34.info5dir a46c5ddir 7a8c9e
R*;*,-
Q $ei$ects output to fi&e o$ e@ice
QQ $ei$ects output an appens to fi&e $ei$ects input f$om fi&e o$ e@iceEJamp&e dir ram:a
P>*
If you "ant to fo$"a$ the output of a comman to anothe$ comman you can use the pipe# You ha@e to connect the commans "ith a Z cha$acte$# +he$e must be at &east one spacebefo$e an afte$ the Z
EJamp&e dir 6 othercommand
But "hat if the secon comman "ants to $ea the input f$om a fi&eV +he so&ution is to usethe fae e@ice 8in8
EJamp&e dir 6 more in:
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 14/92
S>*,+ *4,*5
$am +his is a a$ea of the AROSs inte$na& memo$y that is set up as a fi&e sto$a%e e@ice&ie a is# i&es an i$ecto$ies can be copie into RA fo$ tempo$a$y sto$a%e# But afte$ a $eset its content is &ost# ni& if you on8t "ant the messa%es of a comman to be isp&aye in the "ino" youcan use the 8ni&8 e@ice# EJamp&e e&ete XV Qni&
R/< ,<;-/
No$ma&&y0 a comman b&ocs the She&& unti& it is finishe# You can $un commans in thebac%$oun "ith the $un comman#
EJamp&e $un e&ete XV
Info fi&es
i&es "ith the suffiJ 8#info8 p&ay an impo$tant $o&e in *ane$e$# +hey contain the icon pictu$ean some aitiona& info$mation# *hen you "o$ "ith she&& commans you ha@e to tae theInfo fi&es into account#
B5, +* ->*;- @ S@*++:
C;*< ;*,-; At the she&& p$ompt "ino" type the @o&ume name fo&&o"e by a co&on () si%n to access the
is#o$ eJamp&e is;:
O$ you can use cd is;:
+hen type the comman maei$ a$%umentQ0 "he$e the a$%ument is the name of the$a"e$ you "ish to c$eate#o$ eJamp&e ma;edir documents
You may chec the cu$$ent path contents "ith the i$ comman# Lo%ica&&y it "i&& p$esentyou$ c$eate i$ecto$y#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 15/92
D*+*< +*+ype the ,o&ume name fo&&o"e by a co&on si%n to %et to the is intene#+o e&ete a fi&e o$ $a"e$ you must use the comman .'e&ete path!obFectQ/ T "he$e pathis the fu&& path to the fi&e o$ $a"e$ intene to e&ete#
o$ eJamp&eis;:elete documents/myfile
W-;< @ S; F+* S5* #SFS$
In AROS you$e %i@en the choice to set up pa$titions "ith SS fi&esystem# +his is Fou$na&in%fi&e4system e@e&ope initia&&y fo$ Ami%a machines# Its been po$te to AROS by the AROS'e@e&opment +eam#
A&thou%h the SS han&es fi&enames bi% as :>? cha$s in sie0 some p$o%$ams may not "o$"ith this in of fi&ename &en%ths ('i$ecto$y Opus fo$ one)# AROS4'OS commans a&&comp&y to the :>? cha$ fi&ename SS &imit0 an AROS co$e apps shou& ha@e no p$ob&em"ith that# But as $ecommenation it "ou& bette$ to use D: cha$ fi&enames "hene@e$possib&e#
SFS ,5*&5*54* +**5SS can be optiona&&y set to case sensiti@e e@a&uation of fi&e4names in its st$uctu$e# +he i&e4name case sensi@ity is set in SSfo$mat0 an to set it you ha@e to use the s"itch
CASESENSI+I,E# So by efau&t its not use#
But "ou& you choose this option you&& ha@e to use it acco$in%&y#So fi&enames &ie .+est#fi&e/ isnt the same as .+ES+#fi&e/# +hey both can eJist in the samei$ecto$y an "i&& on&y be accesse if type (o$ passe) acco$in%&y its UPPER o$ &o"e$ casecha$s#
*hen copyin% to othe$ fi&e4systems e@ices0 this can a p$ob&em0 because if you ha@e t"ofi&es "ith on&y this in of case4sensiti@eness iffe$ence0 the $esu&t may be the fi$st fi&e bein%o@e$"$itten by the secon o$ some in of e$$o$ output#
U*+** +*5If you$ SS pa$tition "asnt fo$matte "ith the NORECYCLE' s"itch0 then you&& ha@e aspecia& i$ecto$y "he$e a&& fi&es the e&ete fi&es a$e automatica&&y mo@e name #$ecyc&e#'o bea$ in min that SS by efau&t on&y eeps the &ast D> fi&es e&ete in #$ecyc&ei$ecto$y (any sie as &on% as the$e "as enou%h space on the $i@e "hen e&ete)#+o %ain access to the une&ete i$ open a she&& an type the name of the pa$tition "he$e thefi&e(s) "as p&ace0 fo&&o"e by a co&on ()0 an p$ess ente$#No" type .recycled to access the i$#
You can no" $esto$e any fi&e that happens to be the$e
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 16/92
EJamp&e1.&<&: dh1:1.&<&: .recycled1.&<&:.recycled dir myfile.text
+o $esto$e this fi&e Fust copy (o$ mo@e) it bac to "he$e it be&on%s#
1.&<&:.recycled copy myfile.text dh1:documents/
If the S-O*RECYCLE' s"itch "as use you may use "ane$e$ o$ anothe$ fi&e4mana%e$ &ie'i$ecto$y Opus#
M< -/; 5 5>,*E@e$y e&ete fi&e it "i&& %o into the #$ecyc&e i$ an as fo$ comman output $esu&ts e&ete#
Of cou$se the fi&es in #$ecyc&e "i&& sti&& tae space on the $i@e T a&thou%h you mi%ht ha@einfo othe$"ise#
So you&& ha@e to e&ete fi&es in #$ecyc&e $e%u&a$&y (specia&&y bi% fi&es &ie emu&ation isima%es an ISO8s) so that you a&"ays ha@e f$ee space as isp&aye by the $e&e@antcommans#
'o bea$ in min that if you$e %oin% to use e&ete a &ot of times (specia&&y "ith bi% fi&es)0bea$ in min that the e@ice "i&& pe$fo$m a mo$e s&o" manne$ T because it has to put atabac an fo$th to# o$ that in of situation the$es the NORECYCLE' s"itch of SSfo$mat#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 17/92
S,;> P;-<;<
AROS4'OS Sc$iptin%
AROS4'OS Sc$iptin% &an%ua%es a&&o"s you to accomp&ish simp&e tass "ith a minimumamount of coe# You can "$ite a p$o%$am that p$ints -e&&o0 "o$& to a "ino" she&& usin%
Fust*cho =>ello orld@
*hi&e it %ene$a&&y taes th$ee to ten times as much coe in a &an%ua%e &ie C0 C0 o$ 7a@a0an $eMui$es you to ha@e some &e@e& of eJpe$tise on the %i@en &an%ua%e fo$ that#
Of cou$se AROS4'OS sc$iptin% &an%ua%e is inte$p$ete $athe$ than compi&e0 so spee is&imite to the is access of the sc$ipt fi&es an the comman in@oe#
Sc$iptin% &an%ua%es a$e a&so &ie&y to ha@e featu$es that mae them ynamic# o$ eJamp&e0this mi%ht mean bein% ab&e to %ene$ate coe at $un time an eJecute the ne" coe "ithinthe p$o%$am that %ene$ate it# A&so0 it8s easy to mae @a$iab&es sp$in% into eJistence "henneee# +hey may a&so p$o@ie some fo$m of ata inte$chan%e bet"een app&ications o$ e@en cont$o&them to some e%$ee#
W-;< @ 5,;> +*
+he sc$ipt fi&e is simp&y a teJt fi&e that inc&ues a numbe$ of commans that a$e eJecute Tsomethin% simi&a$ to the batch fi&es on the S4'OS#
+his co@e$s a basic tuto$ia& of "hat you cou& o#
E<+he fi$st thin% you ha@e to o is &oa a teJt eito$ such as E'I+OR in too&s# You can sa@etime by ca&&in% it f$om she&& an typin%
*ditor R$!:my&criptfile
+he p$o%$am "i&& no" &oa#
In the E'I+OR "ino" type
*cho ">ello R%A #his script file lists all the assiBnsperformed."$ssiBn*C%)
No" se&ect SA,E f$om the pu&&4o"n menus# +he fi&e shou& no" be sa@e to $am#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 18/92
E=*,/< ;- 5@*+++ain% the eJamp&e befo$e T open the she&& (If not a&$eay) an type the fo&&o"in% into theNe"She&& "ino" so you$ sc$ipt fi&e can be eJecute#
*xecute R$!:my&criptfile
It "i&& p$esent a&& assi%ns p$esent in the system an $etu$n you to the she&& p$ompt#
E=*,/< ;- *;*;o$ $unnin% the sc$ipt fi&e f$om the "ane$e$ app0 you nee to a a p$oFect icon fi&e to it#+ain% on the on%oin% eJamp&e0 you can o this in the fo&&o"in% manne$ (type in she&&"ino")
Copy en:sys/defDproEect.info as R$!:my&criptfile.info
No"0 you&& %o to the *ane$e$ sc$een an open the Ram 'is "ino"# C&ic once on thesc$iptfi&e icon in RA an se&ect INORA+ION f$om the pu&&4o"n menus# A info$mation"ino" "i&& p$esent the info on the icon se&ecte# C&ic on efau&t +oo& an type in CICON2in teJt %a%et# No" eJit by sa@in% an oub&e4c&ic on the icon#
You "i&& fin that it "i&& no" be eJecute "ithout %oin% th$ou%h the She&&#
C- >* *=*,/-+ype in a She&& "ino" P$otect RAmySc$iptfi&e s
+his "i&& a "hat is ca&&e a p$otection f&a% T this specific f&a% sets the bit S ("hich meanssc$ipt)# No" "hen you ente$ RammySc$iptfi&e f$om the She&& you "i&& %et a &ist of a&& theassi%ns that you ha@e#'on8t fo$%et to ca&& this sc$ipt fi&e it "i&& ha@e to be in the path &istin% o$ e&se you&& ha@e touse a&"ays the fu&& path#
A&so if you "ish to eJecute a sc$ipt fi&e f$om a sc$ipt0 you sti&& ha@e to use the commaneJecute#
C@<< 55* 5,;> +*5
Lie "e sai befo$e0 the sc$ipt fi&e is simp&y a teJt fi&e that inc&ues a numbe$of commans that a$e eJecute T an some of these teJt fi&es a$e actua&&ysystem sc$ipt fi&es#
+h$ee of the most impo$tant fi&es0 "hich $esie in Syss! i$ecto$y0 a$e- 5;/>&5*/*,* (the fi$st fi&e of AROS eJecute)- /5*;&5;/> (a fi&e specia&&y fo$ use$ eitin% an customiin%)- 5@*++&5;/> (the sta$tup fi&e eJecute "hene@e$ a she&& "ino" is
opene)
#$ NOTE:+he suse$4sta$tup fi&e maynot eJist on fi$st boot0 butit can be c$eate#+he ssta$tup4seMuencefi&e "i&& on&y eJecute thisfi&e if it eJists#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 19/92
It must be note that "hi&e the Syss! "as intene initia&&y fo$ AROS4'OS sc$ipt fi&es0 itmay a&so house $eJJ sc$ipt fi&es# By efau&t the RE22 i$ is assi%ne to S $a"e$#
If you "ish to set a iffe$ent $a"e$ Fust eit the fo&&o"in% &ines in the Ssta$tup4seMuence
)f *)&#& C:Rexx!ast $ssiBn R*: &: Run G)%: )%: C:Rexx!ast*nd)f
7ust chan%e the S to "hene@e$ you "ish to ha@e you$ $eJJ sc$ipt fi&es (eJamp&e Sys$eJJ! 4'i$ must be c$eate fi$st if it oes not eJist])#
Un&ess you$e an eJpe$ience pe$son on the use of AROS sc$ipt &an%ua%e (o$ Ami%a'OS)0"e $ecommen you to &ea@e the fi&es as they a$e# Since you can &oose the abi&ity to boot
AROS o$ ha@e some si%nificant pa$t of it unusab&e#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 20/92
AROS ,- R**;*,*
o$ a bette$ une$stanin% of the @a$ious comman pu$poses its he&pfu& if "e i@ie them by someso$t of omain app&ication# +he 3$oup of commans a$e then i@ie &ie this
'is e@ices O$iente commans ABuffe$s Info Re&abe& Assi%n Insta&& SetCache'isChan%e insta&&4iDK4pc SSef$a%ment3UIo$mat Loc SSfo$mat-'+oo& Pa$tition SSMue$y
i&es ! 'i$ecto$ies o$iente commansC' List Sea$chCopy ae'i$ Set'ate'e&ete aeLin So$t'i$ Open +ypei&enote Path Unpac Ientify P$otect ,e$sion7oin Rename
She&& ! CLI o$iente commans A&ias Ne"She&& StatusConC&ip P$ompt Una&iasEcho Resient *hichEnC&i Run *hyEJecute She&&Icon2 Stac
Sc$ipt p$o%$ammin% o$iente commans As au&t ReMuesti&eBeep 3et SetEcho 3eten@ Seten@E&se If SipEnIf Lab UnsetEnSip 5uit Unseten@ai&At ReMuestChoice *ait
AROS system o$iente commans AAuiooes 'eco$ation SetC&oc A'atatypes IP$efs Set'efau&tont A@ai& LoaResou$ce Set1eyboa$Chan%e+asP$i ount SetLoca&e'ate Reboot
isce&&aneous o$iente commansE@a& 5uitAROS ReJJast
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 21/92
As fo$ a simp&e esc$iption of these cate%o$ies
- +he is e@ice o$iente commans co@e$ the basics of c$eation an atamanipu&ation an info$mation on the AROS suppo$te sto$a%e @o&ume#- +he fi&e an $a"e$ type commans co@e$ fo$m the o$ina$y fi&e mana%ement to a
mo$e comp&eJ type commans "hich inc&ue fi&e!i$ soft &inin% an fi&e ha$ &inin%#- +he she&& commans a$e the ones that ea& "ith she&& "o$s0 isp&ay an p$ocess !comman eJecution o$ te$mination- +he sc$ipt p$o%$ammin% commans a$e the ones that cont$o& AROS4'OS sc$ipteJecution f&o"0 @a$iab&e han&in% an e@a&uation0 use$ input0 as "e&& as sc$ipt te$minationconitions- +he system commans a$e subsets of the Co$e system0 "hich may be han&emanua&&y by the use$ usin% the she&&# Loain% an settin% e@ices0 $esou$ces as "e&&p$o@iin% basic system specific info$mation#
Its common fo$ thi$4pa$ty commans to be a&so inc&ue in system i$ecto$ies such as c(Sysc!)# +he i%ita& ocumentation "hich may accompany these shou& be copie into thehe&p (SysLoca&e!Cata&o%s) T +his manua& co@e$s on&y the officia& AROS she&& commans#
+he$es a&so a set of commans p$esent in the C "hich is mo$e e@e&ope$ o$iente0 sothey$e not co@e$e in this ocumentation# +he commans inc&ue
'e@e&ope$ o$iente commansChecem 'e@List ResListCRList Lea*atch +asList'ama%eList LibList Stacksnoop
In this chapte$ "e p$esent the fu&& &ist of use$ a@ai&ab&e she&& commans0 a&phabetica&&yo$%anie# +he &ist inc&ues the comman esc$iption0 usa%e an synopsis0 as "e&& as inputetai&0 eJamp&es on use0 notes an associate commans#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 22/92
AA/-M-*5
U5<*: $$()!*& Gname 7'()*#9 7R*FR*&>9 7R*!H*9 7+%&C$9
Synopsis ILES!0 5UIE+!S0 RERES-!S0 REO,E!S0 'BLSCAN!S
Location SysC
unction Bui&s an $emo@es auio moes "hich A-I can une$stan f$oma &ist inc&ue in 'e@sAuiooes# anua&&y usin% this commanis @e$y unusua&0 since the A-I auio system oes it automatica&&ythe fi$st time it %ets sta$te# It may be usefu&0 ho"e@e$0 ininsta&&ation sc$ipts#
Inputs ILES T specifies "hich esc$ipto$s must be ae ti the cu$$ent auio moe &ist
5UIE+ T supp$esses e$$o$ an output messa%esRERES- T scans 'e@sAuiooes an as a&& esc$ipto$s foun to the cu$$ent &ist'BLSCAN T if specifie0 it "i&& open an immeiate&y afte$ c&ose a nati@e0 oub&e4scan sc$een# On some systems usin% a %$aphic ca$0 it "i&& enab&e samp&e f$eMuencies %$eate$ than =K - "ith nati@e auio# An app$op$iate monito$ $i@e$ in 'e@sonito$s is neee to mae it "o$#
EJamp&es 1.sys $dd$udio!odes *!(10-
As the EU:>12 auio moe to the cu$$ent moes
AB/*;5
U5<*: $dd+uffers 4drie5 7459
Synopsis 'RI,E!A0 BUERS!N
Location SysC
unction A buffe$s to the &ist of a@ai&ab&e buffe$s fo$ a specific $i@e# Ain% buffe$s spees is access but has the $a"bac of usin%up system memo$y (<:= bytes pe$ buffe$)# Specifyin% a ne%ati@enumbe$ subt$acts buffe$s f$om the $i@e#If on&y the 'RI,E a$%ument is specifie0 the numbe$ of buffe$sfo$ that $i@e a$e isp&aye "ithout chan%in% the buffe$a&&ocation#
Inputs 'RI,E 44 the $i@e to a&te$ the buffe$ a&&ocation of BUERS 44 the numbe$ of buffe$s to a (o$ subt$act in case of
a ne%ati@e numbe$) to a $i@e#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 23/92
AD>*5
U5<*: $ddata#ypes files/! '()*#/& R*FR*&>/&
Synopsis ILES!0 5UIE+!S0 RERES-!S0 LIS+!S
Location SysC
unction A'atatypes a&&o"s you to acti@ate a set of specific atatypes#+his mi%ht be necessa$y if ne" atatypes "e$e insta&&e on you$system o$ "e$e not acti@ate on sta$tup#
Inputs ILES 4 +he name of the fi&e(s) of the co$$esponin% atatype#5UIE+ 4 *ont output any messa%es
RERES- T Re$ea eJistin% atatypesLSI+ T +his "i&& isp&ay a &ist of cu$$ent atatypes &oae in
memo$y
Resu&t Stana$ 'OS e$$o$ coes#
EJamp&e $ddata#ypes Bif.datatype R*FR*&>
AUSBC+55*5
U5<*: $dd(&+classes 7'()*#9 7R*!H*9
Synopsis 5UIE+!S0REO,E!S
Location SysC
unction As o$ $emo@es USB e@ice c&asses fo$ Poseion USB stac#
Inputs 5UIE+ T o not sho" e$$o$ an output messa%esREO,E T $emo@es a USB c&ass f$om the cu$$ent &ist
See a&so AUSB-a$"a$e
AUSBH;;*
U5<*: $dd(&+>ardware Gdeice 7()# Gunit9 7'()*#9 7R*!H*9 7$%%9
Synopsis 'E,ICE0UNI+!N05UIE+!S0REO,E!S0ALL!S
Location SysC
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 24/92
unction As o$ $emo@es USB e@ice ha$"a$e f$om Poseion USB stac# Afte$ $eain% the ha$"a$e $i@e$0 a c&ass scan is oneautomatica&&y#
Inputs 'E,ICE T $eMui$e a$%ument0 containinf the abso&ute path an the USB e@ice $i@e$ to a o$ $emo@eUNI+ T optiona& unit numbe$0 if mu&tip&e units a$e suppo$te#'efau&t unit is >
5UIE+ T o not sho" e$$o$ an output messa%esREO,E T $emo@es a USB e@ice $i@e$ f$om the cu$$ent &ist# +o $emo@e ha$"a$e0 the eJact same path an name use fo$ ain% it must be use "ith REO,E as "e&& ALL T t$ies to a a&& units of the %i@en e@ice# If REO,E is specifie0 it $emo@es a&& ent$ies0 effecti@e&y puttin% the stac off&ine#
See a&so AUSBC&asses
A+5
U5<*: $lias
Synopsis NAE0S+RIN3!
Location SysC
unction A&ias a&&o"s you to c$eate an a&te$nate name fo$ othe$ 'OScommans#If A&ias is use "ith no pa$amete$s0 it "i&& isp&ay the cu$$ent &istof A&iases efine "ithin the cu$$ent she&&#
Usin% a pai$ of sMua$e b$acets "ithin an a&ias a&&o"s you top$o@ie the 8ne"8 os comman "ith pa$amete$s#
Inputs NAE 4 +he name of the a&ias to set#
S+RIN3 4 +he @a&ue of the a&ias NAE#
Resu&t Stana$ 'OS e$$o$ coes#
EJamp&e $lias F "#ype 79 numer"
By typin% ' SShe&&4Sta$tup in the she&&0 you a$e actua&&y eJecutin%the comman +ype SShe&&4Sta$tup numbe$# +his "i&& isp&ay thecontents of the SShe&&4Sta$tup fi&e in the she&& "ith &ine numbe$s on the&eft han sie#
See a&so Una&ias
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 25/92
A5
U5<*: $s; Gprompt
Synopsis PROP+!A
Location SysC
unction P$ompts the use$ fo$ an input# Possib&e inputs a$e y fo$ yesan n o$ Retu$n fo$ no# Se&ectin% y sets the $etu$n coe to <#
Inputs PROP+ 44 the st$in% is isp&aye in the "ino"
See a&so ReMuestChoice
A55<
U5<*: $ssiBn 74name5:9 7I4tarBet5J9 7%)	 7*)&#&9 7)&!(#9 7*F*R9
Synopsis NAE0 +AR3E+!0 LIS+!S0 E2IS+S!S0 'ISOUN+!S0 'EER!S0PA+-!S0 A''!S0 REO,E!S0 ,OLS!S0 'IRS!S0 'E,ICES!S
Location SysC
unction ASSI3N c$eates a $efe$ence to a fi&e o$ i$ecto$y# +he $efe$ence is a&o%ica& e@ice name "hich maes it @e$y con@enient to specifyassi%ne obFects usin% the $efe$ence instea of thei$ paths#
If the NAE an +AR3E+ a$%uments a$e %i@en0 ASSI3N assi%ns the%i@en &o%ica& name to the specifie ta$%et# If the NAE %i@en isa&$eay assi%ne to a fi&e o$ i$ecto$y the ne" ta$%et $ep&aces thep$e@ious ta$%et# A co&on must be inc&ue afte$ the NAEa$%ument#
If on&y the NAE a$%ument is %i@en0 any assi%ns to that NAE a$e
$emo@e# If no a$%uments "hatsoe@e$ a$e %i@en0 a&& &o%ica& assi%nsa$e &iste#
Inputs NAE 44 the name that shou& be assi%ne to a fi&e o$ i$+AR3E+ 44 one o$ mo$e fi&es o$ i$ecto$ies to assi%n the NAE toLIS+ 44 &ist a&& assi%ns maeE2IS+S 44 if NAE is not assi%ne0 set the conition f&a% to *ARN'ISOUN+ 44 $emo@e the @o&ume o$ e@ice NAE f$om the os
&ist'EER 44 mae an ASSI3N to a path o$ i$ecto$y that not nee
to eJist at the time of assi%nment# +he fi$st time the
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 26/92
NAE is $efe$ence the NAE is boun to the obFectPA+- 44 path to assi%n "ith a non4binin% assi%n# +his means that the assi%n is $e4e@a&uate each time a $efe$ence to NAE is one# Lie fo$ 'EER0 the path oesn8t ha@e to eJist "hen the ASSI3N comman is eJecute
A'' 44 on8t $ep&ace an assi%n but a anothe$ obFect fo$ a NAE (mu&ti4assi%ns)REO,E 44 $emo@e an ASSI3N ,OLS 44 sho" assi%ne @o&umes if in LIS+ moe'IRS 44 sho" assi%ne i$ecto$ies if in LIS+ moe'E,ICES 44 sho" assi%ne e@ices if in LIS+ moe
A4+
U5<*: $ail 7C>) 6 F$&# 6 ##$% 6 F%(&>9 7> 6 >(!$9
Synopsis C-IP!S0 AS+!S0 +O+AL!S0 LUS-!S0 -W-UAN!S
Location SysC
unction 3i@e a summa$y of the memo$y usa%e an a@ai&abi&ity in thesystem# +o f$ee up unuse memo$y that sti&& may be a&&ocate(&ib$a$ies0 e@ices0 fonts an such p$esent in memo$y but "hich a$ecu$$ent&y not in use)0 use the LUS- option#
Inputs C-IP 44 sho" on&y chip memo$yAS+ 44 sho" on&y fast memo$y+O+AL 44 sho" info$mation on memo$y $e%a$&ess of typeLUS- 44 $emo@e unnecessa$y thin%s $esiin% in memo$y-UAN 44isp&ay mo$e human4$eaab&e @a&ues (%i%abytes as 30 me%abytes as 0 i&obytes as 1)
Notes Chip an fast memo$y a$e associate "ith the Ami%a compute$an may not be app&icab&e on you$ ha$"a$e p&atfo$m#
B**>
U5<*: +eep
Synopsis N!A
Location SysC
unction BEEP p$ouces a beep @ia Intuition 'isp&ayBeep(NULL)#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 27/92
BD;4*;5
U5<*: +indriers 7*H)C*&6R)H*R&6)R9
Synopsis 'E,ICES!S0'RI,ERS!S0'IR!1!A
Location SysC
unction o$ a&& e@ice $i@e$s "ith a #info fi&e in SYSEJpansion0 &oathe e@ice $i@e$ @ia EJec!InitResient() if its PRO'UC+Wtoo&type matches a e@ice that is in the system0 an not yetconfi%u$e#
Inputs 'E,ICES 44 List a&& e@ices0 an thei$ binin%s'RI,ERS 44 List a&& $i@e$s0 an thei$ suppo$te p$oucts'IR i$ecto$yQ 44 'i$ecto$y to sea$ch0 instea of SYSEJpansion!
EJamp&e CBin'$i@e$s
B;*
U5<*: +rea; Gprocess 7$%%6C66*6F9
Synopsis PROCESS!N0POR+0ALL!S0C!S0'!S0E!S0!S
Location SysC
unction BREA1 sens one o$ mo$e si%na&s to a CLI p$ocess#+he a$%ument ZPROCESSZ specifies the nume$ic I' of the CLIp$ocess that you "ish to sen the si%na& to# +he S+A+US comman"i&& &ist a&& cu$$ent&y $unnin% CLI p$ocesses a&on% "ith thei$ I'# You can a&so specify a pub&ic po$t name an sen si%na&8s to thepo$t8s tas#
You can sen a&& si%na&s at once @ia option ALL o$ any combinationof the f&a%s C+RL4C0 C+RL4'0 C+RL4E an C+RL4 by thei$$especti@e options# *hen on&y the CLI p$ocess I' is specifie theC+RL4C si%na& "i&& be sent#
+he effect of usin% the BREA1 comman is the same as se&ectin%the conso&e "ino" of a p$ocess an p$essin% the $e&e@ant eycombination#
+he no$ma& meanin% of the eys is C+RL4C 4 -a&t a p$ocess C+RL4' 4 -a&t a she&& sc$ipt C+RL4E 4 C&ose a p$ocess8 "ino" C+RL4 4 ae acti@e the p$ocess8 "ino"
EJamp&e 1.&<&: +R*$- 1
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 28/92
Sen the C+RL4C si%na& to the p$ocess numbe$e :#
1.&<&: +R*$- K *
Sen the C+RL4E si%na& to the p$ocess numbe$e H#
Notes Not a&& p$o%$ams $espon to these si%na&s0 ho"e@e$ most shou&$espon to C+RL4C#
CD
U5<*: C 7)R9
Synopsis 'IR
Location SysC
unction *ithout a$%ument it sho"s the name of the cu$$ent i$ecto$y#*ith a$%ument it chan%es the cu$$ent i$ecto$y#
Inputs 'IR 44 path to chan%e to cu$$ent i$ecto$y
Notes AROS She&& oes not $eMui$e C' to actua&&y chan%e its path# +heuse$ can Fust type the path name an it "i&& pe$fo$m the same "ay#
C@<*T5P;
U5<*: ChanBe#as;ri Gpriority 7 RC*&& Gprocess numer 9
Synopsis PRIWPRIORI+Y!A!N0PROCESS!1!N
Location SysC
unction +he Chan%e+asP$i comman is use to chan%e the cu$$ent $unp$io$ity of a +as# As AROS is a mu&titasin% ope$atin% system0 you
can ete$mine "hich tass $ecei@e mo$e CPU time by chan%in%thei$ p$io$ities#
+he @a&ue of Zp$io$ityZ can be f$om 4:=K to :=?0 ho"e@e$ @a&ues%$eate$ than H a$e not $ecommene as they can inte$fe$e "ith@ita& system p$ocesses# -i%he$ @a&ues "i&& %i@e tass a hi%he$ CPUp$io$ity# You can use the Status comman to eJamine the &ist of +ass thata$e $unnin% an thei$ p$ocess numbe$s#
EJamp&e 1.&<&: ChanBe#as;ri 1 rocess 1
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 29/92
Set the p$io$ity of the cu$$ent p$ocess to :#
1.&<&: ChanBe#as;ri 1
A&so sets the p$io$ity of the cu$$ent p$ocess to :#
See a&so Status
C+>
U5<*: C%) 7C(#9 7()# Gunit9 7L*# 7$)#99 7&*# 7#*#99
Synopsis UWUNI+!N!10*W*AI+!S03W3E+!S0PWPU+WSWSE+!S0CWCOUN+!S0+E2+
Location SysC
unction -an&e the c&ipboa$8s units ($ea o$ "$ite teJt) f$om the She&&# Itcan be use to sto$e o$ $et$ie@e teJt f$om the c&ipboa$0 o$ countho" many c&ips (units) a$e use#
Inputs 3E+ 44 $et$ie@es teJt f$om a specifie unit numbe$ (if supp&ie)SE+ [+E2+\ 44 sto$es [+E2+\ in a specifie unit numbe$ (if supp&ie)COUN+ 44 counts an isp&ays the numbe$ of fi&&e c&ipboa$ unitsUNI+ T specifies the c&ipboa$ unit to use "ith 3E+ an PU+
actions
*AI+ T use "ith the 3E+ action0 te&&s the comman to "ait fo$ aspecifie unit to be fi&&e "ith ata0 then it "i&& o the 3E+action#
EJamp&e 1.sys C%) (# >ello ()# 2
Sto$es the st$in% 8-e&&o8 in c&ipboa$ unit =
1.sys C%) ()# 2
'isp&ays the contents of c&ipboa$ unit =
1.sys C%) C(#
Counts ho" many c&ipboa$ actua&&y contain ata
1.sys C%) &*#
'e&etes the content of c&ipboa$ unit >#
Notes If no 3E+0 PU+ o$ COUN+ a$%ument is specifie0 teJt "i&& be$et$ie@e# 3E+ "i&& be the efau&t action0 "hi&e efau&t unit "i&& be >(if not eJp$esse)#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 30/92
C-,+>
U5<*: CC%) 7 7()# 6 C%)()#9 Gunitnumer9 7FF9
Synopsis CLIPUNI+WUNI+!N0 ON!S0 O!S
Location SysC
unction Enab&e c&ipboa$ cut!copy!paste functiona&ity in conso&e "ino"san st$in% %a%ets# +his enab&es the use of a system %&oba&c&ipboa$#
Inputs CLIPUNI+WUNI+!N0 ON!S0 O!S
EJamp&e Conclip C%)()#,1
+his "i&& set the %&oba& c&ipboa$ unit to :# +he a@ai&ab&e c&ipboa$scan be chece in c&ips i$
ir Clips:
C->
U5<*: Copy FR! # 7$%%9 7'()*#5 7+(F,n9 7C%*9 7$#*&9 7R9 7C!9
7R*'9
Synopsis RO!0 +O0 ALL!S0 5UIE+!S0 BUWBUER!1!N0 CLONE!S0'A+ES!S0 NOPRO!S0 COWCOEN+!S0 NORE5!S0
Location SysC
unction C$eates ientica& copies of one o$ mo$e fi&es#
Inputs RO 44 mu&tip&e input fi&es+O 44 estination fi&e o$ i$ecto$y
ALL 44 eep scan into sub i$ecto$ies5UIE+ 44 supp$ess a&& output an $eMueste$sBUER 44 buffe$ sie fo$ copy buffe$ in <:= byte b&ocs (efau&t :>=H (W <:=1))CLONE 44 copy comment0 p$otection bits an ate as "e&&'A+ES 44 copy atesNOPRO 44 o not copy p$otection bitsCOEN+ 44 copy fi&e commentNORE5 44 supp$ess $eMueste$s
PA++ERN 44 a patte$n the fi&enames must match
'IREC+ 44 copy moe on&y copy fi&e "ithout any tests o$ options
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 31/92
,ERBOSE 44 %i@es mo$e outputERR*ARN 44 o not p$ocee0 "hen one fi&e fai&eA1E'IR 44 p$ouce i$ecto$iesO,E 44 e&ete sou$ce fi&es afte$ copyin% successfu&'ELE+E 44 o not copy0 but e&ete the sou$ce fi&es
-AR'LIN1 44 mae a ha$&in to sou$ce instea of copyin%SO+LIN1 44 mae a soft&in to sou$ce instea of copyin%OLN1 44 a&so maes &ins to i$ecto$iesO'EL 44 e&ete p$otecte fi&es a&soOO,R 44 a&so o@e$"$ite p$otecte fi&es'ON+O,R 44 o ne@e$ o@e$"$ite estinationORCE 44 'O NO+ USE# Ca&& compatibi&ity on&y#
EJamp&es8Copy 'IREC+ teJt PR+8
+his p$ints a fi&e ca&&e teJt# 4 Copy mana%es a &ot of such casesautomatica&&y0 but maybe this option is neee sometimes#
'etai&einfo
ROSou$ce fi&e(s)# o$ i$ecto$ies0 a&& containe fi&es a$e sou$ce fi&es#ay ha@e stana$ patte$ns#
+O'estination fi&e o$ fo$ mu&tip&e sou$ces estination i$ecto$y#'estination i$ecto$ies a$e c$eate (inc&uin% a&& neee pa$enti$ecto$ies)#
ALLScan i$ecto$ies $ecu$si@e&y
5UIE+Copy is comp&ete&y si&ent he$e# Rea&&y no output is %i@en0 a&so no$eMuests fo$ missin% iss o$ othe$ p$ob&ems]
BUWBUERSpecify the numbe$ of <:= byte buffe$s fo$ copyin%# 'efau&t a$e =>>buffe$s [:>>1B memo$y\# One buffe$ is minimum sie0 but shou&ne@e$ be use#
PA+WPA++ERNPA++ERN a&&o"s to specify a stana$ os patte$n0 a&& fi&e ha@e tomatch# +his is usefu& "ith ALL option#
CLONE+he fi&e comment0 ate an p$otection bits of the sou$ce fi&es a$ecopie to estination fi&e o$ i$ecto$y#
'A+ES+he ate info$mation of sou$ce is copie to estination#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 32/92
NOPRO+he p$otection bits of sou$ces a$e NO+ copie# So the estination%ets the efau&t bits [$"e\#
COWCOEN+
+he fi&e comment is copie to estination#
NORE5No stana$ 'OS $eMuests a$e isp&aye0 "hen an e$$o$ occu$s#
'IREC+Ce$tain e@ices o not a&&o" some of the use 'OS pacet $eMuesttypes# +his option is a $ea&&y easy copy comman0 "hich on&y openssou$ce an estination i$ect&y "ithout any tests an checs#Options ALL0 PA+0 CLONE0 'A+ES0 NOPRO0 CO0 A1E'IR0 O,E0'ELE+E0 -AR'0 SO+0 OLN10 O'EL0 OO,R0 'ON+O,R anmu&tip&e input fi&es cannot be specifie to%ethe$ "ith 'IREC+# +hisoption nees one input an one output fi&e#*hen you "ant to e&ete a soft&in0 "hich oes no &on%e$ point toa @a&i fi&e0 you nee this option as "e&&#
,ERBOSECopy %i@es aitiona& output#
ERR*ARNCopy no"s an $etu$ns the D types of os#&ib$a$y e$$o$s< *ARN 4 +he p$ocessin% of one fi&e fai&e0 Copy sips this fi&ean p$ocees the neJt#:> ERROR 4 +he c$eation of a i$ecto$y o$ any othe$ ba e$$o$happene# Copy Muits afte$ that#=> AIL 4 A $ea&&y ha$ e$$o$ happene (No memo$y0 EJaminefai&e0 ###)# Copy Muits afte$ that#*hen option ERR*ARN is use0 the $esu&t < (*ARN) %ets $esu&t :>(ERROR)# So Copy abo$ts e@e$y time an e$$o$ occu$$e#
A1E'IR A&& names specifie in RO fie& a$e taen as i$ecto$ies0 "hichmust be c$eate#
O,E+he fi&es a$e not copie0 but mo@e (o$ $ename)# +his means thatafte$ mo@e ope$ation the sou$ce oes no &on%e$ eJist#
'ELE+E+his oes not copy anythin%0 but e&ete the sou$ce fi&es]
-AR'W-AR'LIN1Instea of copyin% the fi&es0 a ha$ &in is c$eate# +his on&y "o$s0"hen estination is on same e@ice as sou$ce# *hen ALL option isspecifie0 the i$ecto$ies a$e scanne $ecu$si@e&y0 e&se Copy
p$ouces &ins to the i$ecto$ies#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 33/92
SO+WSO+LIN1Instea of copyin% i$ecto$ies0 a soft &in is c$eate# +hese &ins a$euseab&e bet"een iffe$ent e@ices a&so# Soft &ins a$e on&y c$eatefo$ i$ecto$ies# i&es a$e sippe he$e# Option ORCELIN1 is
the$efo$e a&"ays set to t$ue#
OLN1WORCELIN1*hen &inin% of i$ecto$ies shou& be possib&e0 this option isneee#
O'ELWORCE'ELE+E*hen this option is enab&e0 fi&es a$e e&ete a&so0 "hen they a$ee&ete p$otecte#
OO,RWORCEO,ER*RI+E*hen this option is enab&e0 fi&es a$e o@e$"$itten a&so0 "hen theya$e p$otecte#
'ON+O,RW'ON+O,ER*RI+E+his option p$e@ents o@e$"$itin% of estination fi&es#
Notes Soft&ins a$e not officia& suppo$te by OS an may be an%e$ous# Isu%%est not to use this option]See section About &ins fo$ possib&e p$ob&ems#
See a&so 'e&ete0 Rename0 ae'i$0 aeLin
C->T-PAR
U5<*: Copy#o$R 7GF)%*9 7(&+9 7'()**#9
Synopsis ILE!A0USB!S05UIE+!S
Location SysC
unction Copies (o$ sens) a fi&e to pa$a&&e&#e@ice o$ usbpa$a&&e&#e@ice#
Inputs ILE 44 Eithe$ a fi&e0 a i$ecto$y o$ a patte$n to match#USB 44 Use usbpa$a&&e&#e@ice#5UIE+ 44 Supp$esses any output to the she&&#
Resu&t Stana$ 'OS $etu$n coes#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 34/92
C/
U5<*: C(# GstrinB 7C>$R GranBe 6 R GranBe 7&*$R$#R GstrinB99
Synopsis S+RIN3!A0CWC-AR!10*W*OR'!10SWSEPARA+OR!1
Location SysC
unction EJt$acts some cha$acte$s o$ fu&& "o$s f$om a st$in%#
Use$ can set a be%in an an en position fo$ both C-AR an *OR'a$%uments the fo$me$ eJt$acts cha$acte$s0 the &atte$ a "ho&e iiom#*o$s a$e sepa$e by a se&ectab&e cha$acte$ ca&&e SEPARA+OR# 'efau&tis space (. .)0 but a st$in% can be use as "e&&#
Use$ may specify a position $an%e "ith numbe$s0 in the fo$m .P:4P=/#
P: is the fi$st cha$acte$!"o$ to eJt$act f$om the o$i%ina& st$in%0 .4/ isthe minus cha$acte$ "hi&e P= is the &ast cha$acte$!"o$ to eJt$act# Ifon&y a position is eJp$esse0 cut "i&& eJt$act Fust a sin%&echa$acte$!"o$0 un&ess a hyphen4minus cha$acte$ is p&ace befo$e o$afte$ the numbe$ P4 eJt$acts e@e$ythin% p&ace in the st$in% sta$tin%"ith the P position0 "hi&e 4P "i&& eJt$act e@e$ythin% f$om the be%innin%of the st$in% stoppin% at the P position#
EJamp&es EJamp&e :1.sys Cut "$ yellow flower" C>$R M
"
eJt$act one cha$acte$#
EJamp&e =1.sys Cut "$ yellow flower" C>$R N812
&o" f&oeJt$act f$om cha$acte$ to :=#
EJamp&e D1.sys Cut "$ yellow flower" C>$R 8M
A ye&&o"EJt$act f$om cha$acte$ : to K "ithout specifyin% the be%innin% position#
EJamp&e H1.sys Cut "$ yellow flower" C>$R 108
f&o"e$eJt$act f$om cha$acte$ :> of the st$in% unti& the en#
EJamp&e <1.sys Cut "orld of Commodore" R 2 &*$R$#R "o"
mmeJt$act the secon "o$ (usin% the use$4efine sepa$ato$ .o/)#
Resu&t Stana$ 'OS $etu$n coes#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 35/92
D*
U5<*: ate 7Gday9 7Gdate9 7Gtime9 7# 6 H*R Gfilename9
Synopsis 'AY0'A+E0+IE0+OW,ER!1
Location SysC
unction 'isp&ays o$ sets the system ate an!o$ time#
Inputs 'AY 44 sets ate by name (onay0 +uesay0 ### 0 tomo$$o"0yeste$ay)'A+E 44 sets ate in fo$mat ''44YY# o$ eithe$ thenumbe$ o$ the fi$st D &ette$s of the month in En%&ish#
+IE 44 sets time in fo$mat --SS+O 44 output is sent to fi&e
EJamp&e 1.&ys: date 28fe80N1.&ys: date 21:10
D*/<
U5<*: euB
Location SysC
unction Acti@ates bui&t4in AROS ebu%%e$ (SA')
EJamp&e 1.&ys: deuB
D*,-;-
U5<*: ecoration
Location SysC
unction A&&o"s use$ efinab&e sins fo$ the intuition "ino"s0 menus an%a%ets# It must be &aunche befo$e *ane$e$ 4 usua&&y in theSsta$tup4seMuence
Notes See a&so iprefs
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 36/92
D*+
U5<*: elay 4n5 7#)C- 6 #)C-&9
Synopsis +IE!N0+IC1W+IC1S!S
Location SysC
unction *ait a ce$tain amount of tics c&oc (:!<> of a secon)#
Inputs +IC1W+IC1S 44 time unit in tics to "ait fo$#
Notes An a$bit$a$y &imit is set to :<>>> tics to "ait fo$#
D*+**
U5<*: elete I4name 6 pattern5J 7$%%9 7'()*#9 7FRC*9
Synopsis NAE!10 ALL0 5UIE+0 ORCE
Location SysC
unction 'e&etes fi&es an i$ecto$ies# You may e&ete se@e$a& fi&es ani$ecto$ies by &istin% them sepa$ate&y o$ by usin% "i&ca$s# +oabo$t a mu&tip&e e&ete0 p$ess C+RL4C# 'e&ete "i&& notify the use$ of"hich fi&es it "e$en8t ab&e to e&ete#'e&ete cannot e&ete i$ecto$ies "hich a$e not empty un&ess the ALL option is use# +o supp$ess fi&e an i$ecto$y names f$ombein% p$inte "hi&e e&ete use the 5UIE+ option# If the 88p$otection bit is c&ea$e fo$ a fi&e o$ i$ecto$y0 it may not be e&eteun&ess the ORCE option is use#
Inputs ILE!!A 4 fi&es o$ i$ecto$ies to e&ete (may contain patte$ns) ALL!S 4 $ecu$si@e&y e&ete i$ecto$ies5UIE+!S 4 on8t p$int "hich fi&es!i$ecto$ies "e$e e&ete
ORCE!S 4 e&ete fi&es!i$ecto$ies e@en if they a$e p$otecte f$ome&etion
EJamp&e 1.&ys: elete R$!:#/? $%% FRC*
'e&etes a&& i$ecto$ies an fi&es $ecu$si@e&y in the i$ecto$y RA+e@en if they a$e p$otecte f$om e&etion#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 37/92
D*4L5
U5<*: e%ist
Synopsis (N!A)
Location SysC
unction 3i@es a &ist of $unnin% e@ices a$ess0 @e$sion0 $e@ision0 opencnt0f&a%s0 name
D;
U5<*: ir 74dir 6 pattern59 7# $ 6 ) 6 6 F9 7$%%9 7)R&9 7F)%*&97)#*R9
Synopsis 'IR0OP+!10ALL!S0'IRS!S0ILES!S0IN+ER!S
Location SysC
unction 'IR isp&ays the fi&e o$ i$ecto$y containe in the cu$$ent o$specifie i$ecto$y# 'i$ecto$ies %et &iste fi$st0 then in a&phabetica&o$e$0 the fi&es a$e &iste in t"o co&umns# P$essin% C+RL4C abo$tsthe i$ecto$y &istin%
Inputs ALL 44 'isp&ay a&& subi$ecto$ies an thei$ fi&es $ecu$si@e&y#'IRS 44 'isp&ay on&y i$ecto$ies#ILES 44 'isp&ay on&y fi&es#IN+ER 44 Ente$ inte$acti@e moe#
Notes Inte$acti@e &istin% moe stops afte$ each name to isp&ay a Muestionma$ at "hich you can ente$ commans# +hese commans a$e
Retu$n 44 3o to the neJt fi&e o$ i$ecto$y# E!EN+ER 44 Ente$s a i$ecto$y# 'EL!'ELE+E 44 'e&ete a fi&e o$ an empty i$ecto$y#
C!CO 44 Let the fi&e o$ i$ecto$y be the input of a 'OS comman ("hich specifie afte$ the C o$ CO o$ specifie sepa$ate&y &ate$)# 5!5UI+ 44 5uit inte$acti@e moe# B!BAC1 44 3o bac one i$ecto$y &e@e&#
D5,@<*
U5<*: is;chanBe *H)C*
Synopsis 'E,ICE!A
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 38/92
Location SysC
unction 'ischan%e is intene on&y fo$ $emo@ab&e meia# o$ eJamp&e ifyou ha@e a inte$na& f&oppy is i@e set to noc&ic AROS "i&& not
pe$fo$m is p$esence chec# So you ha@e to manua&&y upate anyis chan%e mae#
Inputs 'E,ICE 44 +he is e@ice unit#
EJamp&e is;chanBe df0:
E,@-
U5<*: *cho 7GstrinB9 7%)*9 7F)R&# Gn9 7%* Gn9 7# Gfilename9
Synopsis S+RIN3!0NOLINE!S0IRS+!1!N0LEN!1!N0+O!1
Location SysC
unction 'isp&ays a st$in%#+he actua& echo comman is capab&e of isp&ayin% p$inte$ escapeseMuences to cont$o& teJt fo$mattin% in She&&0 so E is eMui@a&ent toESC cha$acte$#
Inputs S+RIN3 44 the st$in%s to isp&ayNOLINE 44 no ne"&ine at en of st$in%IRS+ 44 fi$st isp&aye cha$acte$LEN 44 numbe$ of cha$acte$s to isp&ay+O 44 fi&e o$ e@ice to output to
EJamp&e *cho "O*70P0>O*7QO "
+his "i&& c&ea$ the she&& "ino" (Fust &ie a pseuo c&s comman)
E*,
U5<*: *Eect Gdeice
Synopsis 'E,ICE!A
Location SysC
unction EFects meia f$om a e@ice# +his featu$e is not suppo$te by a&&e@ice types#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 39/92
Inputs 'E,ICE 44 Name of e@ice to eFect meia f$om#
See a&so Loa
E+5*
U5<*: *lse
Synopsis (none)
Location SysC
unction Sepa$ate the 8t$ue8 an 8fa&se8 b&ocs of an If statement# +he b&ocfo&&o"in% an E&se comman is eJecute if the conition in the
p$e@ious If statement "as fa&se#
EJamp&e )f *)&#& &ys:es Copy random.deice &ys:es/*lse *cho "Cannot find &ys:es"*nd)f
See a&so If0 EnIf
E,+ ? ES@*++
U5<*: *ndcli o$ *nd&hell
Synopsis (none)
Location SysC
unction +e$minates the cu$$ent Comman &ine inte$face session (she&&p$ocess)#
E
U5<*: *ndif
Synopsis (none)
Location SysC
unction Ens an If b&oc# If the conition of the If comman is fa&se0eJecution "i&& sip to the co$$esponin% EnIf comman0 in case
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 40/92
the$e isn8t an E&se comman p$esent#
EJamp&e )f *)&#& &ys:es Copy random.deice &ys:es/*lse *cho "Cannot find &ys:es"*nd)f
See a&so If0 E&se
E5>
U5<*: *nds;ip
Synopsis (none)
Location SysC
unction Ens a sip comman#
See a&so Sip
E4+
U5<*: *H$% Galue1 Gop Galue2 7G#9 7G%format9
Synopsis ,ALUE:!A0OP0,ALUE=!0+O!10LORA+!1
Location SysC
unction E@a&uate an inte%e$ eJp$ession an p$int the $esu&t# +he $esu&t is"$itten to stana$ output if not the +O s"itch a$e use "hichinstea p$ints the $esu&t to a fi&e#Usin% the s"itch LORA+0 it is possib&e to i$ect ho" to "$ite the$esu&t# Numbe$s p$efiJe by >J o$ XJ a$e inte$p$ete asheJaecima& an those p$efiJe by X o$ > a$e inte$p$ete as Octa&#
A&phabetica& cha$acte$s a$e inicate by a &eain% sin%&e Muotationma$ (8)0 an a$e e@a&uate as thei$ ASCII eMui@a&ent#
Inputs ,ALUE:0 OP0 ,ALUE= 4 +he eJp$ession to e@a&uate# +he fo&&o"in%ope$ato$s a$e suppo$te
Ope$ato$ Symbo&s 4444444444444444444444444444444444 aition subt$action 4 mu&tip&ication
i@ision !
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 41/92
mou&o mo0 0 m0 ^ bit"ise an _ bit"ise o$ Z bit"ise not &eft shift &sh0 L0 &
$i%ht shift $sh0 R0 $ ne%ation 4 eJc&usi@e o$ Jo$0 20 J bit"ise eMui@a&ence eM@0 E0 e
+O 44 i&e to "$ite the $esu&t to
LORA+ 44 p$intf4&ie specification of "hat to "$ite# +he possib&e s"itches a$e
^J 44 heJaecima& output0 "ith i%it ^o 44 octa& output0 "ith i%it ^n 44 ecima& output ^c 44 cha$acte$ output (the ANSI4cha$acte$ co$$esponin% to the $esu&t @a&ue)
By specifyin% n in the LORA+ st$in%0 a ne"&ine is output#
E=*,/*
U5<*: *xecute Gscript 7IGarBumentsJ9
Synopsis ILE!A
Location SysC
unction EJecutes a sc$ipt "ith 'OS commans#
Inputs ILE 44 fi&e to eJecute
See a&so IconJ
F+
U5<*: Fail$t Glimit
Synopsis RCLI!N
Location SysC
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 42/92
unction ai&At sets the $etu$n coe &imit of the cu$$ent she&& sc$ipt# If any comman $etu$ns "ith a fai&u$e coe of this @a&ue o$ hi%he$the sc$ipt sha&& abo$t#Common fai&u$e coes a$e > 4 No e$$o$
< 4 *a$nin% :> 4 E$$o$ => 4 ai&u$e
+he no$ma& @a&ue fo$ the $etu$n coe &imit is :>#
EJamp&e If "e ha@e a sc$ipt "ith the commans
Copy R$!:&omeFile F0: *cho "oneA"
an the fi&e RASomei&e oes not eJist0 the Copy comman "i&&$etu$n "ith
Copy: oEect not found Copy: returned with error code 20
an the sc$ipt "i&& abo$t# -o"e@e$ if you inc&ue the comman
Fail$t 21
then the sc$ipt "i&& comp&ete since the $etu$n coe f$om Copy is&ess than the $etu$n coe &imit#
F/+
U5<*: Fault Gerror numer
Synopsis NUBERS!N!
Location SysC
unction au&t p$ints the messa%e co$$esponin% "ith the e$$o$ numbe$supp&ie# Any numbe$ of e$$o$ numbe$s can be %i@en at once0but they must be sepa$ate by spaces#
EJamp&e 1.&<&: Fault 20Fault 20: oEect not found
+his te&&s you that the e$$o$ coe =>< means that a is obFect cou& not be foun#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 43/92
F+*-*
U5<*: Filenote Gfile Gcomment 7$%%9 7'()*#9
Synopsis ILE!A0COEN+0ALL!S05UIE+!S
Location SysC
unction A a comment to a fi&e o$ i$ecto$y#
i&enote a&&o"s a $ecu$si@e scan of a&& i$ecto$ies ain% commentsto each fi&e!i$ecto$y it fins that matches the fi&e patte$nspecifie#
EJamp&e FILE - Always has to be specified. Can be either a filenamewith a full path or a file pattern that is to be matched.
COMMEN - he A!CII strin" that is to be added as acomment to the file#s$%dir#s$ specified.
o pro&ide a comment that has embedded 'uotationmar(s) precede each 'uote with an asteris(.
I.e.* Filenote FILE+,AM*test.tt COMMEN+/hello/
ALL - 0oolean switch. If specified) Filenote scans thedirectories that match the pattern specified) recursi&ely.
12IE - 0oolean switch. If specified) no dia"nostic tet willbe displayed to standard output.
Resu&t !tandard 3O! return codes.
EJamp&e Filenote ram* hello all
,ecurses throu"h each directory in ,AM* addin" /hello/ as
a filenote to each file%directory.
Notes Output from A,O!4 Filenote is more neat and structured
than thestandard Filenote command.
3oes not yet support multi-assi"ns.
F-;
U5<*: Format R)H*,Grie 7$!*,Gname9 7F& 6 FF&9 7)#% 6 )#%97FRC*9 7'()*#9
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 44/92
Synopsis 'RI,E!1!A0 NAE!1!A0 OS!S0 S!S0 IN+LWIN+ERN+IONAL!S0NOIN+LWNOIN+ERNA+IONAL!S0 ORCE!S0 5UIE+!S
Location SysC
unction o$mat "i&& initia&ise a is to be useab&e by the AROS#
Inputs 'RI,E 44 +he e@ice is unit esi%nationNAE 44 Sets the @o&ume name#OS 44 o$mats the $i@e "ith the O& i&e system (not$ecommene fo$ -'s)#S 44 o$mats the $i@e "ith the ast i&e system#IN+L 44 Enab&es the S suppo$t of inte$nationa& cha$acte$s#ORCE T5UIE+ T It "i&& not isp&ay any output0 o$ina$y o$ e$$o$ messa%es#
EJamp&e Format R)H*,F0: $!*,"!yis;" FF&
+his "i&& fo$mat a is p$esent in the inte$na& f&oppy $i@e "ith thename .yis/ an "ith ast i&e System#
Notes +his comman on&y suppo$ts OS an S fi&e system#
See a&so SSfo$mat0 Info
G*
U5<*: Let Game
Synopsis NAE!A
Location SysC
unction Ret$ie@es the info$mation sto$e in the %i@en &oca& @a$iab&e#
Inputs NAE 4 +he name of the &oca& @a$iab&e#
EJamp&e Let Result2
+his "i&& $et$ie@e the secona$y $etu$n coe of the &ast comman that "as eJecute#
Resu&t Stana$ 'OS e$$o$ coes#
See a&so Set0 unset
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 45/92
G**4
U5<*: Leten Game
Synopsis NAE!A
Location SysC
unction Ret$ie@es the info$mation sto$e in the %i@en %&oba& @a$iab&e#
Inputs NAE 4 +he name of the &oca& @a$iab&e#
EJamp&e Let -ic;start
+his "i&& $et$ie@e the @e$sion of the 1icsta$t RO (AA on&y)#
Resu&t Stana$ 'OS e$$o$ coes#
See a&so Seten@0 unseten@
G=C-;-+
U5<*: LfxControl
Synopsis PRE,EN+`'IREC+`BI+AP`ACCESSWP'BA!S0 ALLO*`'IREC+`BI+AP`ACCESSWA'BA!S0'UP!S
Location SysC
unction Chan%e some inte$na& options of cybe$%$aphics#&ib$a$y
Inputs PRE,EN+`'IREC+`BI+AP`ACCESS T Causes LocBitap+a%List()ca&&s to a&"ays fai&
ALLO*`'IREC+`BI+AP`ACCESS 44 A&&o" Loc1Bitap+a%List() to
%o to %fJ $i@e$ "hich may o$ may not suppo$t it# (efau&t)
'UP 44 Sho" cu$$ent settin%sResu&t Stana$ 'OS $etu$n coes#
G/;/
U5<*: Luru G*rror code 7%$&#$%*R#9
Synopsis 3URU0LWLAS+ALER+!S
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 46/92
Location SysC
unction Ret$ie@es the info$mation about system e$$o$ messa%es0 o$ .3u$umeitations/#
Inputs 3URU T e$$o$ coe to inte$p$etate
EJamp&e 1.sys Buru SSN22SK
$lert Code: SSN22SK #ype: Recoerale &usystem: Badtools.lirary Leneral: Cannot open resource &pecified: (n;nown
I,-=
U5<*: 4From anderer5
Synopsis ILE!A
Location SysC
unction Enab&es a sc$ipt to be $un f$om *ane$e$#+he sc$ipt must ha@e a P$oFect #info fi&e an the 'efau&t +oo& set to .CIcon2/ to $un it#
*hen oub&e4c&ice the sc$ipt fi&e is eJecute in a she&& "ino"opene fo$ this so&e pu$pose#
Inputs ILE 4 +he sc$ipt fi&ename to eJecute#
+oo&types fo$ sc$ipt icon*IN'O* 44 Specification of the she&& "ino" efau&t con>!<>!!K>!Icon2!AutoS+AC1Wn 44 efau&t H>;>USERS-ELLWYESZNO 44 efau&t YES*AI+Wn 44 *ait n secons befo$e c&osin% "ino" (efau&t =)
'ELAYWn 44 *ait n!<> secons befo$e c&osin% "ino"
See a&so EJecute
I*
U5<*: )dentify Gfile6dirJ 7H*R+&*9
Synopsis ILE!!A0 ,ERBOSE!S
Location SysC
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 47/92
unction Ientifies the fi&e type o$ i$ecto$y#
Inputs ILE 44 fi&e to be $eco%nie ,ERBOSE 44 acti@ates @e$bose output
EJamp&e )dentify s:startup8seTuence
&:startup8seTuence #ext/$scii
It "i&& ientify the sta$tup4seMuence as a teJt fi&e#
I
U5<*: )f Gcondition
Synopsis NO+!S0*ARN!S0ERROR!S0AIL!S00E5!103+!103E!10,AL!S0E2IS+S!1
Location SysC
unction Ca$$y out a&& the commans in a b&oc if a %i@en conitiona& is t$ue#(A b&oc is a $un of comman &ines ene "ith an E&se o$ EnIfcomman#) o$ e@e$y If comman the$e must be a co$$esponin%EnIf#If the conition is fa&se0 comman eJecution "i&& sip to the
co$$esponin% E&se of EnIf comman#
Inputs NO+ 44 Ne%ates the @a&ue of the conition*ARN 44 +$ue if the p$e@ious $etu$n coe "as %$eate$ than o$ eMua& to <#ERROR 44 +$ue if the p$e@ious $etu$n coe "as %$eate$ than o$ eMua& to :>#AIL 44 +$ue if the p$e@ious $etu$n coe "as %$eate$ than o$ eMua& to =>#E50 3E0 3+ 44 +$ue if the fi$st @a&ue is eMua&0 %$eate$ than o$ eMua& $especti@e&y %$eate$ than the secon#
,AL 44 Inicate that the compa$ison shou& t$eat the st$in%s as nume$ica& @a&ues#E2IS+S st$in%Q 44 +$ue if the fi&e o$ i$ecto$y st$in%Q eJists#
EJamp&e )f 00 L# 200 H$% echo "00 is Breater than 200"*lse )f *)&#& &:(ser8&tartup echo "(ser8&tartup script found in &:" *xecute &:(ser8&tartup *nd)f*nd)f
Notes ERROR an AIL "i&& on&y be app$op$iate if the fai& &e@e& of the
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 48/92
sc$ipt is set @ia ai&At (the stana$ fai& &e@e& is :> an if any $etu$ncoe eJcees o$ eMua&s this @a&ue0 the sc$ipt "i&& be abo$te)#
See a&so E&se0 EnIf0 ai&At
I-
U5<*: )nfo 7)&-&9 7H%&9 7L%<9 7+%C-&9 7*H)C*&9
Synopsis 'IS1S!S0 ,OLSW,OLUES!S0 3OO'ONLY!S0 BLOC1S!S0'E,ICES!
Location SysC
unction Sho" info$mation on fi&e system e@ices an @o&umes# *hen %i@enno a$%uments0 info$mation on a&& e@ices an @o&umes foun in thesystem is isp&aye# If info$mation is "ante on&y fo$ some specifice@ices0 these names may be %i@en as a$%uments##
Inputs 'IS1S 44 sho" info$mation on fi&e system e@ices ,OLS 44 sho" info$mation on @o&umes3OO'ONLY 44 on8t sho" any info$mation on ba e@ices o$@o&umesBLOC1S 44 sho" aitiona& b&oc sie an usa%e info$mation'E,ICES 44 e@ice names to sho" info$mation about
EJamp&e )nfo
(nit &iUe (sed Free Full *rrs &tate #ype ameForeiBn harddis;: VNK.1! WWN.W! 1MW.K! M1X 0 read/write F& or;enchR$!: M.0! W.1! W.1! 12X 0 read/write F& Ram is;
See a&so o$mat0 SSfo$mat
I>;*5
U5<*: )prefs
Synopsis (N!A)
Location SysC
unction Initia&ises p$efe$ences fi&es on sta$tup#
Notes +his is a comman eJecute on sta$tup by the ssta$tup4seMuencesc$ipt fi&e# So no actua& nee of the comman afte$"a$s
See a&so 'eco$ation
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 49/92
I5++
U5<*: )nstall Grie 7+#9 7C>*C-9 7FF&9
Synopsis 'RI,E!A0 NOBOO+!S0 C-EC1!S0 S!S
Location SysC
unction Sa@es a boot b&oc to a f&oppy is#If the NOBOO+ is appointe it "i&& be ab&e to be boot on compute$sta$tup (Ami%a on&y)
Inputs 'RI,E 44 sho" info$mation on fi&e system e@icesNOBOO+ 44 shou& be set on PC &oppy $i@esC-EC1 44 ,e$ify the eJistin% boot b&oc S 44 o$ S fo$matte &oppy iss
EJamp&e )nstall df0: +# FF&
Notes +his is a p$etty use&ess comman fo$ PC4'$i@es0 since most systems$eMui$e %$ub to be p$esent on is fo$ AROS to boot#
See a&so Insta&&4iDK4pc0 o$mat
I5++&<;/2&386&>,
U5<*: )nstall8Bru28iSMN8pc Geice G(nit 7,n9 7LR(+ ldr9 7FRC*%+$9
Synopsis 'E,ICE!A0 UNI+!1!1!A0 PN!1!N0 3RUB!1!A0 ORCELBA!S
Location SysC
unction Insta&&s the 3RUB = boot&oae$ to the boot b&oc of the specifieis o$ pa$tition0 basica&&y main% a is e@ice o$ pa$titionbootab&e#
Inputs 'E,ICE 44 'e@ice name (e#%# ata#e@ice)
UNI+ 44 Unit numbe$PN 44 Specifies a pa$tition numbe$# If specifie0 3RUB is insta&&e to this pa$tition8s boot b&oc# Othe$"ise0 3RUB is insta&&e to the is8s boot b&oc#3RUB 44 Path to 3RUB i$ecto$y#ORCELBA 44 o$ce use of LBA moe#
EJamp&e )nstall8Bru28iSMN8pc *H)C* ata.deice ()# 0LR(+ >0:oot/Bru
Notes +his cou& se$ious&y ama%e you$ ata in the ha$ $i@e
See a&so Pa$tition0 o$mat
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 50/92
I5++&386&>, #- *>;*,*$
U5<*: )nstall8iSMN8pc Geice G(nit 7,n9 7LR(+ ldr9 7-*R*% ;nl97FRC*%+$9
Synopsis 'E,ICE!A0 UNI+!1!1!A0 PAR+I+IONNUBERWPN!1!N0 3RUB!1!A0ORCELBA!S
Location SysC
unction It basica&&y mae a is e@ice o$ pa$tition bootab&e0 by insta&&in%o& 3RUB @e$sion : onto it# It is no" obso&ete0 ue to the fact thatcu$$ent AROS bui&s an ist$ibutions use 3RUB =# It8s ept in thismanua& fo$ $efe$ence an histo$ica& $easons#
Inputs 'E,ICE 44 e@ice name (i#e# ata#e@ice)
UNI+ 44 Unit numbe$PN 44 Pa$tition numbe$ (a@ice the fi$st AROS ffs pa$tition)3RUB T Insta&& the 3$ub boot &oae$ on this e@ice1ERNEL 4 Insta&& the AROS 1e$ne& onto this e@iceORCELBA 44 o$ce use of Lo%ica& B&oc A$essin%
EJamp&e install8iSMN8pc deice ata.deice unit 0 1 Brudh0:oot/Bru ;ernel dh0:oot/aros8iSMN.BU
Notes +his cou& se$ious&y ama%e you$ ata in the ha$ $i@e
See instea Insta&&4%$ub=4iDK4pc
-
U5<*: Qoin 7F)%*9 I4file 6 pattern5J $&6# 4filename5
Synopsis ILE!!A0ASW+O!1!A
Location SysC
unction 7oin maes one bi% fi&e of a&& &iste fi&es by puttin% them to%ethe$ inthe o$e$ %i@en# +he estination fi&e may not ha@e the same nameas any of input fi&es# You must supp&y a estination fi&e name# +heo$i%ina& fi&es $emain unchan%e# Any numbe$ of fi&es can be 7oinein one ope$ation#
Inputs ILE 44 fi&es to Foin+OWAS 44 the name of the combine fi&e
EJamp&e Qoin #ext1.doc #ext2.doc $& #ext.doc
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 51/92
+his "i&& me$%e the t"o teJt fi&es into one#
Resu&t Stana$ 'OS e$$o$ coes#
L
U5<*: %a ame
Synopsis NAE!A
Location SysC
unction 'ec&a$es a &abe& in a sc$ipt fi&e# +his &abe& may be $efe$$e to in a
Sip comman#Inputs NAE 4 +he name of the &abe&#
EJamp&e )f # *)&#& &:(ser8&tartup &;ip o(ser&eT*nd)f
Fail$t 20*xecute &:(ser8&tartup'uit
%a o(ser&eT*cho "o (ser8&tartup found"
If the fi&e is not foun it sips to the e$$o$ messa%e
See a&so Sip
LL5
U5<*: %i%ist
Synopsis (N!A)
Location SysC
unction 3i@es a &ist of &oae &ib$a$ies a$ess0 @e$sion0 $e@ision0 opencnt0f&a%s0 name
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 52/92
L5
U5<*: %ist 74dir 6 pattern 6 filename59 7 $# 4pattern59 7-*<&9 7$#*&9
7$#*&9 7# 4name59 7&(+ 4strinB59 7&)C* 4date59 7(# 4date59 7'()C-97+%C-9 7>*$9 7F)%*&9 7)R&9 7%FR!$# 4strinB59 7$%%9
Synopsis 'IR!0PWPA+!10'A+ES!S0NO'A+ES!S0+O!10SUB!10SINCE!10UP+O!105UIC1!S0BLOC1!S0NO-EA'!S0ILES!S0'IRS!S0LORA+!10ALL!S
Location SysC
unction Lists etai&e info$mation about the fi&es an i$ecto$ies in the cu$$enti$ecto$y o$ in the i$ecto$y specifie by 'IR#+he info$mation fo$ each fi&e o$ i$ecto$y is p$esente on a sepa$ate
&ine0 containin% the fo&&o"in% info$mation
4 name4 sie (in bytes)4 p$otection bits4 ate an time
Inputs 'IR 44 +he i$ecto$y to &ist# If &eft out0 the cu$$ent i$ecto$y "i&& be &iste#PA+ 44 'isp&ay on&y fi&es matchin% 8st$in%81EYS 44 'isp&ay the b&oc numbe$ of each fi&e o$ i$ecto$y
'A+ES 44 'isp&ay the c$eation ate of fi&es an i$ecto$iesNO'A+ES 44 'on8t isp&ay ates+O (name) 44 *$ite the &istin% to a fi&e instea of stoutSUB (st$in%) 44 'isp&ay on&y fi&es0 a subst$in% of "hich matches the subst$in% 8st$in%8SINCE (ate) 44 'isp&ay on&y fi&es ne"e$ than 8ate8UP+O (ate) 44 'isp&ay on&y fi&es o&e$ than 8ate85UIC1 44 'isp&ay on&y the names of fi&esBLOC1 44 i&e sies a$e in b&ocs of <:= bytesNO-EA' 44 'on8t p$int any heae$ info$mationILES 44 'isp&ay fi&es on&y
'IRS 44 'isp&ay i$ecto$ies on&yLORA+ 44 Specify the &ist output in p$intf4sty&e ALL 44 List the contents of i$ecto$ies $ecu$si@e&y
+he fo&&o"in% att$ibutes of the LORA+ st$in%s a$e a@ai&ab&e
^A 44 fi&e att$ibutes^B 44 sie of fi&e in b&ocs $athe$ than bytes^C 44 fi&e comment^' 44 c$eation ate^E 44 fi&e eJtension^ 44 @o&ume name^1 44 fi&e ey b&oc numbe$
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 53/92
^L 44 sie of fi&e in bytes^ 44 fi&e name "ithout eJtension^N 44 fi&e name^P 44 fi&e path^S 44 supe$cee by ^N an ^P obso&ete
^+ 44 c$eation time
EJamp&e %ist C:irectory "C:" on ednesday 128ec8VV$dd+uffers KKK 88p8rwed 028&ep8VV 11:1:S1$ssiBn S220 88p8rwed 028&ep8VV 11:1:S1$ail W2M 88p8rwed 028&ep8VV 11:1:S1Copy SN2 88p8rwed 028&ep8VV 11:1:S1elete 1VW2 88p8rwed 028&ep8VV 11:1:S1*xecute KKS2 88p8rwed 028&ep8VV 11:1:S1%ist 10M 88p8rwed 028&ep8VV 11:1:S1)nstaller 10VVN 8888rwed 028&ep8VV 11:1:S1hich 10NM 88p8rwed 028&ep8VV 11:1:S1
V files 8 2WK loc;s used
Resu&t Stana$ 'OS e$$o$ coes#
See a&so 'i$
L-
U5<*: %oad Gdeice
Synopsis 'E,ICE!A
Location SysC
unction Loas meia into a e@ice# +his featu$e is not suppo$te by a&&e@ice types#
Inputs 'E,ICE 44 Name of e@ice to &oa meia into#
L-;*5-/;,*
U5<*: %oadresource Gname
Synopsis NAE!!A
Location SysC
unction +his comman "i&& &oa a system $esou$ce fi&e such as a &ib$a$y0e@ice0 font0 cata&o%
+he a@anta%e is that it spees up the ata access to the
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 54/92
$esou$ces &oae into memo$y#
Inputs NAE T +he $esou$ce name
EJamp&e 1.&<&: %oadresource %is:asl.lirary
+his "i&& &oa the as& $eMueste$ &ib$a$y into memo$y#
Resu&t Stana$ 'OS e$$o$ coes#
L-,
U5<*: %oc; Gdrie 76FF9 7Gpass;ey9
Synopsis 'RI,E!A0ON!S0O!S0PASS1EY
Location SysC
unction Loc "i&& cause the specifie e@ice o$ pa$tition to be mae "$ite4p$otecte o$ "$ite4enab&e# +his "$ite p$otection is a soft "$itep$otection "hich is han&e by the @o&ume fi&e system# -ence thep$otection "i&& be $eset (to "$itab&e) on the neJt system $eboot#
It is possib&e to specify an optiona& passey "hich can be use topass"o$ p$otect the &ocin%# +he same passey that is use to&oc the @o&ume must be use to un&oc the @o&ume# +he passeymay be any numbe$ of cha$acte$s in &en%th#
+he @o&ume %i@en US+ be the e@ice o$ $oot @o&ume name0 not anassi%n#
Inputs 'RI,E T +he $i@e to be &oce!un&oceON0O T Sets the &oc status eithe$ on o$ offPASS1EY T A pass"o$ passe as st$in% to p$otect the &oc o$ confi$m the un&oc#
EJamp&e 1.&<&: %oc; or;:
+his "i&& &oc the @o&ume ca&&e *o$ "ithout a passey#
1.&<&: %oc; or;:1.&<&: !a;eir or;:&omeirCanYt create directory or;:#est!a;eir: is; is write8protected
+he @o&ume *o$ is &oce0 so it is impossib&e to c$eate a i$ecto$y#
1.&<&: %oc; or;: FF
+his "i&& un&oc the @o&ume "o$#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 55/92
1.&<&: %oc; or;: !yassword
+his "i&& &oc *o$ "ith the passey yPass"o$
Resu&t Stana$ 'OS e$$o$ coes#
M*;
U5<*: !a;edir Game 7$%%9
Synopsis NAE!0ALL!S
Location SysC
unction C$eate ne" empty i$ecto$ies "ith specifie names#
Inputs NAE 44 names of the i$ecto$ies that shou& be c$eate ALL 44 c$eates inte$meiate i$ecto$ies
EJamp&e !a;edir Ram:test
+his "i&& c$eate a i$ecto$y ca&&e .+est/ in Ram 'is
Notes ae'i$ oes not c$eate an icon fo$ a ne" i$ecto$y#
M*+
U5<*: !a;elin; Gfrom Gto 7>$R9 7FRC*9
Synopsis RO!A0 +O!A0 -AR'!S0 ORCE!S
Location SysC
unction C$eate a &in to a fi&e
Inputs RO 44 +he name of the &in +O 44 +he name of the fi&e o$ i$ecto$y to &in to-AR' 44 If specifie0 the &in "i&& be a ha$4&in efau&t is to c$eate a soft4&in ORCE 44 A&&o" a ha$4&in to point to a i$ecto$y
EJamp&e !a;elin; ls c:list
C$eates a .&s/ fi&e "ith a symbo& &in (sym&in) to the .&ist/comman in c
Resu&t Stana$ 'OS e$$o$ coes#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 56/92
Notes Not a&& fi&e systems suppo$t &ins#
M-/
U5<*: !ount Geice GFrom
Synopsis 'E,ICE!0 RO!1
Location SysC
unction Loas an mounts a e@ice
Inputs 'E,ICE 44 +he e@ice type to be mounte
RO 44 Specify a mount fi&e containin% e@ice info$mation
EJamp&e !ount *H&:F$#0
ounts a fat e@ice efine on A+> fi&e
Resu&t Stana$ 'OS e$$o$ coe#
N*5@*++
U5<*: ewshell 7Gindow pts9 7Gscript file9
Synopsis *IN'O*0RO
Location SysC
unction C$eate a ne" she&& in a ne" conso&e "ino"# +his "ino" "i&&become the acti@e one# +he ne" she&& inhe$its most att$ibutes ofthe pa$ent she&& &ie the cu$$ent i$ecto$y0 stac sie0 p$ompt an soon# -o"e@e$0 it is comp&ete&y inepenent of the pa$ent she&&#
+he "ino" be&on%in% to the ne" she&& may be specifie by usin%the *IN'O* ey"o$#
Inputs *IN'O* 44 Specification of the she&& "ino"
2 44 numbe$ of piJe&s f$om the &eft e%e of the sc$een Y 44 numbe$ of piJe&s f$om the top e%e of the sc$een *I'+- 44 "ith of the she&& "ino" in piJe&s -EI3-+ 44 hei%ht of the she&& "ino" in piJe&s
+I+LE 44 teJt to appea$ in the she&& "ino"8s
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 57/92
tit&e ba$ AU+O 44 the "ino" automatica&&y appea$s "hen the p$o%$am nees input o$ output AL+ 44 the "ino" appea$s in the specifie sie an position "hen the oom %a%et is c&ice
BAC1'ROP 44 the "ino" is a bac$op "ino" CLOSE 44 inc&ue a c&ose %a%et INAC+I,E 44 the "ino" is not mae acti@e "hen opene NOBOR'ER 44 the "ino" is bo$e$&ess0 on&y the sie0 epth an oom %a%ets a$e a@ai&ab&e NOCLOSE 44 the "ino" has no c&ose %a%et NO'EP+- 44 the "ino" has no epth %a%et NO'RA3 44 the "ino" cannot be $a% imp&ies
NOCLOSE NOSI6E 44 the "ino" has no sie %a%et SCREEN 44 name of a pub&ic sc$een to open the "ino"
on SIPLE 44 if the "ino" is en&a$%e the teJt eJpans to fi&& the a@ai&ab&e space SAR+ 44 if the "ino" is en&a$%e the teJt "i&& not eJpan *AI+ 44 the "ino" can on&y be c&ose by se&ectin% the c&ose %a%et o$ ente$in% C+RL4#
RO 44 i&e to eJecute befo$e $eso$tin% to no$ma& she&& ope$ations# If nothin% is specifie SShe&&4Sta$tup is use#
EJamp&e ew&hell "C:10/10/NK0/KM0/!y own shell/C%&*"
+his "i&& open a she&& "ino" "ith the name .y o"n she&&/#
See a&so Enc&i
O>*
U5<*: Open Game
Synopsis NAE!A
Location SysC
unction +his comman is a conteJt sensiti@e fi&e!$a"e$ &oae$ ! eJecute$ !isp&ay too&#It means that it "i&& ha@e app$op$iate action set fo$ each fi&e type#Such as
- if you open a eJecutab&e comman it "i&& be &aunche as if a
$un Qni& comman "as eJecute#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 58/92
- If a teJt o$ ima%e fi&e is opene0 it "i&& &aunch u&ti@ie"#- If you open a $a"e$ it "i&& p$esent you a "ane$e$ fi&e
b$o"se$ type "ino" an &ets you na@i%ate
Inputs NAE 44 +he fi&e o$ $a"e$ name
EJamp&e pen Ram:
It "i&& open a "ane$e$ "ino" "ith the $am is contents#
P;-
U5<*: artition 7Geice G(nit9 7&<&&)Z*,Gn9 7R-&)Z*,G9 7!$R-97)*9 7FRC*9 7'()*#9
Synopsis 'E,ICE0 UNI+!N0 SYSSI6E!1!N0 *OR1SI6E!1!N0 A2*OR1!S0*IPE!S0 ORCE!S0 5UIE+!S
Location SysC
unction Pa$tition c$eates eithe$ one o$ t"o AROS pa$titions on a %i@en $i@e#EJistin% pa$titions "i&& be ept un&ess the *IPE option is specifie(o$ a se$ious bu% occu$s0 fo$ "hich "e tae no $esponsibi&ity)#Pa$titions c$eate by this comman must be fo$matte befo$e theycan be use#
By efau&t0 a sin%&e SS System pa$tition is c$eate usin% the&a$%est amount of f$ee space possib&e# A sma&&e$ sie can be chosenusin% the SYSSI6E a$%ument# +o a&so c$eate a *o$ pa$tition0eithe$ *OR1SI6E o$ A2*OR1 must aitiona&&y be specifie# +he*OR1SI6E a$%ument a&&o"s the sie of the *o$ pa$tition to bespecifie0 "hi&e settin% the A2*OR1 s"itch maes the *o$pa$tition as &a$%e as possib&e#
+he fi&esystems use by the System an *o$ pa$titions may bespecifie usin% the SYS+YPE an *OR1+YPE a$%uments$especti@e&y# +he a@ai&ab&e options a$e SS (Sma$t i&esystem0 theefau&t)0 an SInt& (the t$aitiona& so4ca&&e ast i&esystem)#
+he 'OS e@ice names use fo$ the System an *o$ pa$titionsmay be specifie usin% the SYSNAE an *OR1NAE a$%uments$especti@e&y# By efau&t0 these a$e '-> an '-:#
If you "ish to use on&y AROS on the $i@e you $un this commanon0 you can specify the *IPE option0 "hich est$oys a&& eJistin%pa$titions on the $i@e# Be @e$y ca$efu& "ith this option it e&etesa&& othe$ ope$atin% systems an ata on the $i@e0 an cou& beisast$ous if the "$on% $i@e is accienta&&y pa$titione#
If the $i@e oes not a&$eay contain an eJtene pa$tition0 one is
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 59/92
c$eate usin% the &a$%est a@ai&ab&e $e%ion of f$ee space# +he AROSpa$titions a$e then c$eate as a &o%ica& pa$tition "ithin# +his isin o$e$ to mae the aition of fu$the$ pa$titions easie$#
Inputs 'E,ICE 44 'e@ice $i@e$ name (ata#e@ice by efau&t)
UNI+ 44 +he $i@e8s unit numbe$ (> by efau&t0 "hich is the p$ima$y maste$ "hen usin% ata#e@ice)SYSSI6E 44 +he System (boot) pa$tition sie in me%abytes#SYS+YPE 44 +he fi&e system to use fo$ the system pa$tition0 eithe$ SS (the efau&t) o$ SInt&#SYSNAE 44 +he name to use fo$ the system pa$tition (efau&ts to'->)#*OR1SI6E 44 +he *o$ (secona$y) pa$tition sie in me%abytes# +ouse this option0 SYSSI6E must a&so be specifie#A2*OR1 44 ae the *o$ pa$tition as &a$%e as possib&e# +o use this option0 SYSSI6E must a&so be specifie#*OR1+YPE 44 +he fi&e system to use fo$ the "o$ pa$tition0 eithe$ SS (the efau&t) o$ SInt&#*OR1NAE 44 +he name to use fo$ the "o$ pa$tition (efau&ts to '-:)#*IPE 44 'est$oy a&& othe$ pa$titions on the $i@e0 inc&uin% those use by othe$ ope$atin% systems (CAU+ION])#ORCE 44 'o not as fo$ confi$mation befo$e pa$titionin% the $i@e#5UIE+ 44 'o not p$int any output# +his option can on&y be use
"hen ORCE is a&so specifie#R'B 44 C$eate on&y R'B pa$titions0 no BR o$ EBR pa$titions "i&& be c$eate#
EJamp&e artition ata.deice 1 &<&&)Z* 200 !$R-
Notes +his is a @e$y an%e$ous comman T use it on&y if you$e su$e of"hat you$e oin%# Usin% -'+oo&BoJ instea of this comman maysometimes be safe$0 as it sho"s "he$e pa$titions "i&& be c$eate onthe $i@e befo$e chan%es a$e "$itten to is# -o"e@e$0 -'+oo&BoJcan be un$e&iab&e#
P@
U5<*: Path [i$Q\ [A''\ [S-O*\ [RESE+\ [REO,E\ [5UIE+\ [-EA'\
Synopsis PA+-!0A''!S0S-O*!S0RESE+!S0REO,E!S05UIE+!S0-EA'!S
Location SysC
unction Chan%es the sea$ch path fo$ commans# *ithout a$%uments itsho"s the path#
Inputs PA+- 44 path
A'' 44 as path
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 60/92
S-O* 44 sho"s pathRESE+ 44 $emo@es eJistin% path an $ep&aces it by ne" pathREO,E 44 $emo@es the %i@en path5UIE+ 44 supp$esses ia&o% "hen a path is not foun-EA' 44 inse$ts path at be%innin% of path &ist
EJamp&e path dh0:wor; add
As the "o$ i$ in h> to the sea$ch path#
P@P;
U5<*: $#>$R# 7)R Gpath name9 7F)%* Gpath name9 7$ Gdeice name 6directory name 6 file name9
Synopsis 'IR!10ILE!10A''!1!
Location SysC
unction EJt$acts i$ecto$y o$ fi&e name f$om a path0 o$ assemb&es a path#+his comman can b$ea o"n i$ecto$y an fi&e names into thei$$especti@e i$ecto$y an fi&e name components0 an is a&so ab&e toassemb&e o$ $e4assemb&e the ini@iua& names into combine pathnames a%ain# +his can be @e$y usefu& in sc$ipts#
Inputs 'IR path nameQ T eJt$acts the i$ecto$y component f$om the path nameQILE path nameQ T eJt$acts the fi&e component f$om the path
nameQ A'' T bui&s a path f$om e@ice nameQ0 i$ecto$y nameQ an
fi&e nameQ
EJamp&es 1.sys$#>$R# )R or;:ippo/luto
or;:ippo
Obtains the i$ecto$y name component of a path#
1.sys $#>$R# F)%* or;:ippo/luto
luto
Obtains the fi&e name component of a path#
1.sys $#>$R# $ or;: ippo luto
or;:ippo/luto
Bui&s a comp&ete ne" path name f$om %i@en components
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 61/92
1.sys $#>$R# $ Y$#>$R# )Ror;:ippo/lutoY Foo
or;:ippo/Foo
Remo@es the &ast pa$t of the path name0 then $ep&ace it "ith a ne"one
P>*
U5<*: ipe Gcommand
Synopsis COAN'!
Location SysC
unction Uses the `pcha$ an ̀ mcha$ en@i$onment @a$iab&es to sp&itthe COAN' into f$a%ments#
*he$e `pcha$ is seen0 the commans on eithe$ sie a$e connecte"ith a PIPE f$om the &eft sie8s Output() to the $i%ht sie8s Input()#
*he$e `mcha$ is seen0 the commans a$e eJecute in seMuence0"ith no PIPE bet"een them0 an Input() an Output() comes f$omthe te$mina&#
Inputs COAN' 44 the comman to eJecute
EJamp&e 1.sys set Dpchar "6"1.sys set Dmchar "P"1.sys echo >ello P echo orld
>elloorld
1.sys #ype &:&tartup8&eTuence 6 &ort
Notes +he `pcha$ an `mcha$ en@i$onment @a$iab&es a$e use to
ete$mine "he$e to sp&it the comman0 an "hat action tope$fo$m#
Note that `pcha$ an `mcha$ a$e &imite to = cha$acte$s 4 anyaitiona& cha$acte$s "i&& be si&ent&y i%no$e#
P+
U5<*: P&ay 7GF)%*9
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 62/92
Synopsis ILE!S
Location SysC
unction P&ay a soun fi&e0 usin% atatypes#&ib$a$y#
Inputs ILE 44 i&ename to p&ay#
EJamp&e Soun shou& p&ay to the efau&t auio e@ice
P;->
U5<*: P$ompt 7G#&9
Synopsis OP+S!1
Location SysC
unction Specify the p$ompt fo$ the cu$$ent she&&#
Inputs PROP+ 44 +he p$ompt to set as a st$in%# +he fo&&o"in%commans may be use in a p$intf in of sty&e#
N 44 c&i numbe$
S 44 name of the cu$$ent i$ecto$y R 44 $etu$n coe of the &ast ope$ation
If no p$ompt is specifie ^N#^SQ is use as efau&t#
EJamp&e rompt "epir Risti.X "
epir Risti.10
(if the CLI numbe$ "as :>)#
P;-*,
U5<*: rotect 7Gfile9 7F%$L&9 7$6&(+9 7$%%9 7'()*#9
Synopsis ILE!A0LA3S0A''!S0SUB!S0ALL!S05UIE+!S
Location SysC
unction A o$ $emo@e p$otection bits f$om a fi&e o$ i$ecto$y#P$otect a&&o"s the use of patte$n matchin% an $ecu$si@e i$ecto$yscans to p$otect many fi&es!i$ecto$ies at any one time#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 63/92
Inputs ILE 44 Eithe$ a fi&e0 a i$ecto$y o$ a patte$n to match#LA3S 44 One o$ mo$e of the fo&&o"in% f&a%s
S 4 Sc$ipt
P 4 Pu$e A 4 A$chi@e R 4 Rea * 4 *$ite E 4 EJecute ' 4 'e&ete
A'' 44 A&&o"s the bits to be set an hence a&&o"ab&e#SUB 44 A&&o"s the bits to be c&ea$e an hence not a&&o"ab&e# ALL 44 A&&o"s a $ecu$si@e scan of the @o&ume!i$ecto$y#5UIE+ 44 Supp$esses any output to the she&&#
Resu&ts Stana$ 'OS $etu$n coes#
EJamp&e rotect ram: e add all
Recu$ses the $am @o&ume an attaches the eJecutab&e bit#
P5D*4L5*;
U5<*: sde%ister
Synopsis S-O*ROO+!S05UIC1!S0S+RIN3S!S
Location SysC
unction 3i@e a etai&e &ist of a&& the USB e@ices cu$$ent&y in the system#It is app$eciate that you inc&ue the output of this p$o%$amfo$ bu% $epo$tin%#
Inputs S-O*ROO+!S 4 No$ma&&y0 the $oot hub(s) a$e eJc&ue f$om theoutput0 as they on8t contain @a&uab&e info$mation# Specifythis s"itch0 if you $ea&&y "ant to see it#
5UIC1!S 4 If %i@en0 omits some output0 ec$easin% @e$bosity#S+RIN3S!S 4 +$ies to $ea out a &ist of st$in% esc$ipto$s thee@ice contains0 mi%ht cause some e@ices to c$ash0 hence thisis isab&e by efau&t#
EJamp&e 1. sde%ister
P5E;;-;L-<
U5<*: sd*rror%oB
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 64/92
Synopsis NOLUS-!S0'EBU3!S
Location SysC
unction P$ints out a&& info$mation0 "a$nin% an e$$o$ messa%es accumu&ateso fa$ n the Poseion stac# +hese messa%es "i&& automatica&&y bef&ushe0 so ca&&in% PsE$$o$Lo% anothe$ time "i&& on&y $e@ea& thene" messa%es since the &ast ca&&#
Inputs NOLUS-!S 4 If %i@en0 outputs the e$$o$s "ithout isca$in% them#'EBU3!S 4 P$ints some aitiona& ebu% info$mation# If
Poseion e@e$ seems to han%0 inc&ue the output of PsE$$o$&o%"ith 'EBU3 enab&e#
EJamp&e 1. sd*rror%oB F%(&> ram:*rrors.loB
Rei$ects the e$$o$ &o% to fi&e E$$o$s#&o% in RA0 "ithout f&ushin%e$$o$s f$om memo$y#
P5S,L-*;
U5<*: sd&tac;%oader
Synopsis (N!A)
Location SysC
unction Use inte$na&&y to $un Poseion USB Stac# It8s automatica&&yc$eate by +$ient#
)/
U5<*: 5uit
Synopsis RC!N
Location SysC
unction EJit the sc$ipt eJecution $etu$nin% some so$t p$e4efine coe
Inputs RC 44 the $etu$n coe
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 65/92
)/;-5
U5<*: 'uitaros
Synopsis (N!A)
Location SysC
unction +his comman is on&y of inte$est if you8$e usin% a fu&&4sc$eenhost system 4 fo$ ease of use# It Muits the -ost c&ient###
R*--
U5<*: Reoot 7C%9
Synopsis COL'!S
Location SysC
unction Reboots the machine# Any p$o%$ams an ata in memo$y "i&& be&ost an a&& is acti@ity "i&& cease# ae su$e no is access isbein% ca$$ie out by you$ compute$#
Inputs COL' 44 te&&s to pe$fo$m co& (comp&ete) $eboot of the machine# Othe$"ise on&y AROS is $esta$te#
R*+*+
U5<*: Relael R)H*,Grie $!*,Game
Synopsis 'RI,E!A0 NAE!A
Location SysC
unction Rename a @o&ume
Inputs 'RI,E 44 +he @o&ume to $enameNAE 44 +he ne" name
EJamp&e Relael rie F0: ame "!yis;"
+his "i&& $ename the is in f> as y'is#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 66/92
R**
U5<*: Rename 7IFR!J9 Gname 7#6$&9 Gname 7'()*#9
Synopsis RO!A!0+OWAS!A05UIE+!S
Location SysC
unction Renames a i$ecto$y o$ fi&e# Rename can a&so act &ie the UNI2 m@comman0 "hich mo@es a fi&e o$ fi&es to anothe$ &ocation on is#
Inputs RO 44 +he name(s) of the fi&e(s) to $ename o$ mo@e# +he$emay be many fi&es specifie0 this is use "hen mo@in% fi&es into a ne" i$ecto$y#
+OZAS 44 +he name "hich "e "ish to ca&& the fi&e#
5UIE+ 44 Supp$ess any output f$om the comman#
Resu&t Stana$ 'OS e$$o$ coes#
EJamp&e Rename letter1.doc letter2.doc letters
o@es &ette$:#oc an &ette$=#oc to the i$ecto$y &ette$s#
Rename ram:a ram: TuietRename from ram:a to ram: Tuiet
Rename from,ram:a to,ram: Tuiet
A&& @e$sions0 $enames fi&e a to b an oes not output any ia%nostic info$mation#
R*/*5C@-,*
U5<*: ReTuestchoice #)#%*,G#itle +<,G+ody L$L*#&,GLadBets7Guscreen9
Synopsis +I+LE!A0BO'Y!A03A'3E+S!A!0PUBSCREEN!1
Location SysC
unction A&&o"s Ami%a'OS sc$ipts to ha@e access to the EasyReMuest()function fo$ input#
Inputs +I+LE 4 +he teJt to isp&ay in the tit&e ba$ of the $eMueste$#BO'Y 4 +he teJt to isp&ay in the boy of the $eMueste$#3A'3E+S 4 +he teJt fo$ each of the buttons#PUBSCREEN 4 +he name of the pub&ic sc$een to open the
$eMueste$ on#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 67/92
Resu&t Stana$ Coes
EJamp&e ReTuestChoice "#his is a title" "#his isOa ody" ;ay6Cancel
+his is se&f4eJp&anato$y0 eJcept fo$ the N# +his is the eMui@a&ent of usin% a 8n8 in C to %et a ne"&ine in the boy of the $eMueste$# +his $eMueste$ "i&& open on the *o$bench sc$een#
ReTuestChoice #itle,"#his is a title" +ody,"#his isOaody" LadBets,;ay6Cancel u&creen,(&.1
+his "i&& o eJact&y the same as befo$e eJcept that it "i&& open on the 'i$ecto$y Opus pub&ic sc$een#
Notes +o p&ace a ne"&ine into the boy of the $eMueste$ use n o$ N#
+o p&ace a Muotation ma$ in the boy of the $eMueste$ use #
+he CLI temp&ate %i@es the 3A'3E+S option as AL*AYS %i@en thisis iffe$ent f$om the o$i%ina& p$o%$am# +his "ay0 "e o not ha@eto chec to see if the %a%ets ha@e been %i@en#
R*/*5F+*
U5<*: ReTuestfile 7R$*R,Grawer97F)%*,GFile9 7$##*R,Gattern97#)#%*,G#itle9 7&)#)H*,Gositie9 7*L$#)H*,GeBatie97$CC*#$##*R,G$cceptpattern9 7R*Q*C#$##*R,GReEectpattern9 7&$H*!*97!(%#)&*%*C#9 7R$*R&%<9 7)C&9 7(+&CR**,Guscreen97))#)$%H%(!*&9
Synopsis 'RA*ER0ILE!10PA++ERN!10+I+LE!10POSI+I,E!10NE3A+I,E!10 ACCEP+PA++ERN!10RE7EC+PA++ERN!10SA,EO'E!S0UL+ISELEC+!S0'RA*ERSONLY!S0NOICONS!S0PUBSCREEN!10INI+IAL,OLUES!S
Location SysC
unction C$eates fi&e $eMueste$# +he se&ecte fi&es "i&& be isp&aye sepa$ateby spaces# If no fi&e is se&ecte the $etu$n coe is < ("a$n)#
Inputs 'RA*ER 44 initia& content of $a"e$ fie&ILE 44 initia& content of fi&e fie&PA++ERN 44 content of patte$n fie& (e#%# XV#c)+I+LE 44 tit&e of the ia&o% boJPOSI+I,E 44 st$in% fo$ the &eft buttonNE3A+I,E 44 st$in% fo$ the $i%ht button ACCEP+PA++ERN 44 on&y fi&es "hich match the patte$n a$e isp&aye
RE7EC+PA++ERN 44 fi&es "hich match the patte$n a$en8t isp&ayeSA,EO'E 44 $eMueste$ is isp&aye as sa@e $eMueste$
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 68/92
UL+ISELEC+ 44 mo$e than one fi&e can be se&ecte'RA*ERSONLY 44 on&y $a"e$s a$e isp&ayeNOICONS 44 no icon fi&es (XV#info) a$e isp&ayePUBSCREEN 44 $eMueste$ is opene on the %i@en pub&ic sc$eenINI+IAL,OLUES 44 sho"s the @o&umes
Resu&t Stana$ 'OS e$$o$ coes#
EJamp&e ReTuestfile R$*R,@or;:ocuments@ $##*R,@?.doc@#)#%*,@&elect a document file@
R*/*5S;<
U5<*: ReTuest&trinB 7&#R)L9 7#*#9 7#)#%*9 7L$&9 7)#>9 7&$F*9
7*R&)	 7*CR<#9 7C!$R*9 7(+&CR**9
Synopsis S+RIN30 +E2+!10 +I+LE!10 NO3A'S!S0 *I'+-!N0 SAE!S0PERSIS+!S0 ENCRYP+!S0 COPARE!10 PUBSCREEN!1
Location SysC
unction Sho"s a $eMueste$ "ith a st$in% %a%et fo$ use$ input#
Input S+RIN3 44 Initia& content of st$in% %a%et#+E2+ 44 Labe& st$in%#+I+LE 44 +it&e st$in% of $eMueste$# +his a&so as $a%ba$0
c&ose%a%et an a epth%a%et#NO3A'S 44 Supp$ess %a%ets "hen +I+LE a$%ument is %i@en#*I'+- 44 inima& "ith as numbe$ of cha$acte$s#SAE 44 -ie use$ input "ith #PERSIS+ 44 Intuition is b&oce unti& $eMueste$ is Muitte#ENCRYP+ 44 Enc$ypt $esu&t befo$e $etu$nin%# ReMui$es that one of
these en@i$onment @a$iab&es is set USER0 USERNAE o$ LO3IN#COPARE 44 If the input st$in% is not eMua& to the a$%ument of COPARE $etu$n *ARN#PUBSCREEN 44 Open $eMueste$ on %i@en pubsc$een#
Notes PERSIS+ oesn8t a&"ays "o$#*I'+- is not imp&emente#
R*5*
U5<*: Resident 7Game9 7GFile9 7R*!H*9 7$9 7R*%$C*9 7(R*6FRC*97&<&#*!9
Synopsis NAE0 ILE0 REO,E!S0 A''!S0 REPLACE!S0 PUREWORCE!S0
SYS+E!S
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 69/92
Location SysC
unction Sto$es a comman in memo$y (no &on%e$ $eMui$es $e&oain%f$om is each time it is eJecute)# +o ensu$e a comman can bemae $esient chec the pu$e f&a% T Use .&ist/ comman#
Inputs NAE T Comman nameILE0 4 i&e comman nameREO,E T Remo@es the comman f$om memo$y A'' T A to memo$yREPLACE T $ep&ace any eMua& comman ent$y a@ai& in memo$yPUREWORCE T o$ce to mae it pu$e $esientSYS+E T Sho"s the systems $esient coe se%mens o$ a coeto the system $esient &ist# Lea@e "e&& a&one]
See a&so *hich0 List
R*5L5
U5<*: Res%ist
Synopsis (N!A)
Location SysC
unction 3i@es a &ist of &oae $esou$ces a$ess an names#
R/
U5<*: Run 7'()*#9 7**C(#*9 GCommand
Synopsis COAN'!0 5UIE+!S0 E2ECU+E!S
Location SysC
unction Run a p$o%$am0 that is sta$t a p$o%$am as a bac%$oun p$ocess#+hat means it oesn8t tae o@e$ the pa$ent she&&#
Inputs COAN' 44 the p$o%$am to $un to%ethe$ "ith its a$%uments5UIE+ 44 a@ois p$intin% of the bac%$oun CLI8s numbe$E2ECU+E T EJecutes a she&& sc$ipt instea
Notes +o mae it possib&e to c&ose the cu$$ent she&&0 $ei$ect the outputusin%
Run )%: proBram arBuments
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 70/92
S*;,@
U5<*: &earch 7FR!9 I4name 6 patternJ 7&*$RC>9 4strinB 6 pattern5 7$%%97(!9 7'()*#9 7'()C-9 7F)%*9 7$##*R9 7%)*&,umer9
Synopsis RO!10 SEARC-!10 ALL!S0 NONU!S0 5UIE+!S0 5UIC1!S0 ILE!S0PA++ERN!S0 LINES!N
Location SysC
unction Sea$ch &oos th$ou%h the fi&es containe in the RO i$ecto$y fo$a specifie st$in% (SEARC-) in case the ALL s"itch is specifie0 thesubi$ecto$ies of the RO i$ecto$y a$e a&so sea$che# +he nameof a&& fi&es containin% the SEARC- st$in% is isp&aye to%ethe$ "ith
the numbe$s of the &ines "he$e the st$in% occu$$e#If C+RL4C is p$esse0 the sea$ch "i&& be abanone# C+RL4' "i&&abanon sea$chin% the cu$$ent fi&e#
Inputs NONU 44 no &ine numbe$s a$e p$inte5UIE+ 44 on8t isp&ay the name of the fi&e bein% sea$che5UIC1 44 mo$e compact outputILE 44 &oo fo$ a fi&e "ith a specific name $athe$ than a st$in% in a fi&ePA++ERN 44 use patte$n matchin% "hen sea$chin%CASE 44 use case sensiti@e patte$n matchin% "hen sea$chin%
LINES 44 eJt$a &ines afte$ a &ine match "hich shou& be sho"n
Notes If the obFect is foun0 the conition f&a% is set to ># Othe$"ise it8sset to *ARN#
S*
U5<*: &et 7Game G&trinB9
Synopsis NAE0S+RIN3!
Location SysC
unction Set a &oca& en@i$onment @a$iab&e in the cu$$ent she&&# If any %&oba&@a$iab&es ha@e the same name the &oca& @a$iab&e "i&& be useinstea#
+his instance the @a$iab&e is on&y accessib&e f$om "ithin the she&& it"as efine#
If no pa$amete$s a$e specifie0 the cu$$ent &ist of &oca& @a$iab&es is
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 71/92
isp&aye#
Inputs NAE 4 +he name of the &oca& @a$iab&e to set#S+RIN3 4 +he @a&ue of the &oca& @a$iab&e NAE#
Resu&t Stana$ 'OS e$$o$ coes#
EJamp&e &et Qump
Sets a &oca& @a$iab&e ca&&e 7ump to the @a&ue of <#
See a&so 3et0 Unset
S*,,@*
U5<*: &etcache Geice 7G%ines9 7GReadahead9 7C<+$C-9
Synopsis 'E,ICE!A0 LINES!N0 REA'A-EA'!N0 NOCOPYBAC1!S
Location SysC
unction SetCache sets the $ea4ahea cache of a Sma$t i&e system e@ice(usua&&y a ha$ $i@e)# It is not the same as the buffe$s you cana usin% the ABuffe$s comman#+he $ea4ahea cache is use to p$e4fetch ata "hich may beneee &ate$ on# Because most ha$ iss on8t suffe$ a speepena&ty "hen $eain% a bit mo$e ata this can inc$easepe$fo$mance $astica&&y#
Inputs 'E,ICE 4 +he e@ice name you "ant to set the $ea caches#'ont use the co&on () at the en#
LINES 4 Cont$o&s the numbe$ of $ea4ahea buffe$s# Each buffe$ isa specific bytes in sie0 "hich you can cont$o& usin% theREA'A-EA' pa$amete$# It is a %oo iea to set this to at
&east K buffe$s o$ mo$e#REA'A-EA' T +he numbe$ of bytes "hich the fi&e system "i&& $ea
ahea# +his cont$o&s the sie of the buffe$s you
specifie "ith the LINES pa$amete$#NOCOPYBAC1 4 +u$ns off copybac moe# +he$e shou&n8t be any
$eason "hy you "ant to o this0 sho$t of testin% pu$poses#
EJamp&e &etCache &F&R)H* %ines,M Read$head,M1V2
Sets the $ea4ahea cache to K buffe$s of K:;= bytes each
Notes +his comman is specific fo$ Sma$t i&esystem $i@es0 an it "on8t"o$ "ith the ast i&e System (S) o$ anothe$#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 72/92
S*C+-,
U5<*: &etCloc; I%$6&$H*6R*&*#J
Synopsis LOA'!S0SA,E!S0RESE+!S
Location SysC
unction SetC&oc can be use to- Loa the time f$om the batte$y bace4up c&oc- Sa@e the time to the batte$y bace4up c&oc- Reset the batte$y bace up c&oc#
EJamp&e &etCloc; %$
*i&& set the system time f$om the batte$y bace4up c&oc# In mostsystems this "i&& be one automatica&&y u$in% system sta$tup#
&etCloc; &$H*
*i&& set the time of the batte$y bace4up c&oc f$om the cu$$ent systemc&oc time#
&etCloc; R*&*#
*i&& $eset the batte$y bace4up to a @a&ue of the :st 7anua$y :;?K>>>>>># +his is most&y use if the batte$y bace4up c&oc has an e$$o$an "i&& not $espon to no$ma& &oa an sa@e commans#
Notes 'ate0 +ime P$efe$ence settin% (AROS Use$ anua&)
S*D*/+F-
U5<*: &etefaultFont GFontname GFontsiUe 7&CR**9
Synopsis ON+NAE!A0ON+SI6E!N!A0SCREEN!S
Location SysC
unction Set the efau&t system!sc$een ont
Inputs ON+NAE 44 the name of the fontON+SI6E 44 the sie of the fontSCREEN 44 if specifie set the efau&t sc$een font othe$"ise set the efau&t system font#
EJamp&e &etefaultFont ttcourier 12
Notes +he efau&t system font must be mono space (non4p$opo$tiona&)
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 73/92
S*D*
U5<*: &etate GFilename 7G**-$<9 7G$#*9 7G#)!*9 7$%%9
Synopsis ILE!A0 *EE1'AY0 'A+E0 +IE0 ALL!S
Location SysC
unction Chan%es the fi&e timestamp#
Inputs ILE 44 the name of the font*EE1'AY 44 specifies the "eeay'A+E 44 specifies the ate+IE 44 specifies the time ALL 44 Chan%es a&& fi&es an i$s timestamps in the path %i@en
EJamp&e &etate ram:testfile 128128200
S**4
U5<*: Seten@ [ame9 7&$H*9 7G&trinB9
Synopsis NAE0SA,E!S0S+RIN3!
Location SysC
unction Sets a %&oba& @a$iab&e f$om the cu$$ent she&&# +hese @a$iab&es can beaccesse f$om any p$o%$am eJecutin% at any time#
+hese @a$iab&es a$e usua&&y not sa@e in the EN,ARC i$ecto$y0hence they can on&y be use by p$o%$ams u$in% the cu$$enteJecution of the ope$atin% system# *hen usin% SA,E a$%ument0the @a$iab&e is a&so sa@e in EN,ARCIf no pa$amete$s a$e specifie0 the cu$$ent &ist of %&oba& @a$iab&esa$e isp&aye#
Inputs NAE 4 +he name of the %&oba& @a$iab&e to set#SA,E 4 Sa@e the @a$iab&e a&so in EN,ARCS+RIN3 4 +he @a&ue of the %&oba& @a$iab&e NAE#
Resu&t Stana$ 'OS e$$o$ coes
EJamp&e &eten *F*)#R *ditor
Any p$o%$am that accesses the @a$iab&e 'EE'I+OR "i&& be ab&e to fin out the name of the teJt4eito$ the use$ "ou& &ie to use0 by eJaminin% the contents of the @a$iab&e#
See a&so 3eten@0 Unseten@#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 74/92
S**-;
U5<*: &et-eyoard G-eymap
Synopsis 1EYAP!A
Location SysC
unction Set the eymap fo$ the cu$$ent she&&#
Inputs 1EYAP 44 the eymap to use "ith the cu$$ent she&&
EJamp&e &et-eyoard s
aes the cu$$ent she&& use the S"eish eymap#
Notes +o mae a ce$tain eymap be the efau&t fo$ a&& she&&s0 use thep$efe$ences input p$o%$am so specify you$ efau&t choice#
SFS-;
U5<*: &F&format R)H* Grie 7$!* Gname9 7C$&*&*&)#)H*9 7R*C<C%*6&>R*C<C%*9
Synopsis 'RI,E!A!10 NAE!A!10 CASESENSI+I,E!S0 NORECYCLE'!S0
S-O*RECYCLE'!SLocation SysC
unction o$mat "i&& initia&ise a is to be useab&e by the AROS "ith the SSfi&e system#
Inputs 'RI,E 44 +he e@ice is unit esi%nationNAE 44 Sets the @o&ume name#CASESENSI+I,E 44 Enab&es iffe$ent fi&ename e@a&uationpe$fo$me acco$in% uppe$ o$ &o"e$ case cha$s use #NORECYCLE' 44 'oes not c$eate a #$ecyc&e i$ in the e@ice
fo$matte#S-O*RECYCLE' 44 Enab&es the #$ecyc&e $a"e$ to sho" up anbe se&ecte *ane$e$ o$ 'i$Opus etc# as a no$ma& i$ ent$y on thee@ice fo$matte
EJamp&e Format rie >1: ame "!yis;" &>R*C<C%*
+his "i&& fo$mat the secona$y is pa$tition (o$ a secon ha$ is)"ith the name .yis/ an "ith Sma$t i&e System#
Notes +his comman on&y suppo$ts SS fi&e system#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 75/92
SFS/*;
U5<*: &F&Tuery Geice
Synopsis 'E,ICE!A!1
Location SysC
unction It basica&&y p$o@ies info$mation on a %i@en fo$matte SS e@icepa$tition#
Inputs 'RI,E 44 +he e@ice is unit esi%nationNAE 44 Sets the @o&ume name#CASESENSI+I,E 44 Enab&es iffe$ent fi&ename e@a&uationpe$fo$me acco$in% uppe$ o$ &o"e$ case cha$s use #NORECYCLE' 44 'oes not c$eate t$ashcan $a"e$ in the e@ice
fo$matte#S-O*RECYCLE' 44 C$eates a t$ashcan $a"e$ on the e@icefo$matte
EJamp&e 10.&K: sfsTuery wor;:
&F&Tuery information for wor;: 4&F& Hersion 1.25&tart/end8offset : 0x00000000:00102000 8 0x00000000:SafN000eice $) : 4standard5+ytes/loc; : 12 #otal loc;s : 1VSNVNCache accesses : 1VS2S1N Cache misses : SVWS 40X5Read8ahead cache : Mx M1V2 ytes 4Copyac;5Flush timeout : act. 20s 8 inact. 0.s!ax ame %enBth : 10W
& uffers : 1000&F& settinBs : 7R*C<C%*9
Notes +his comman on&y suppo$ts SS fi&e system#
S@*++
U5<*: She&& [COAN'WCommanQ\ [ROW$omQ\
Synopsis COAN'!1!0RO
Location SysC
unction Sta$t a she&& (inte$acti@e o$ bac%$oun)#
Inputs COAN' 44 comman &ine to eJecuteRO 44 sc$ipt to in@oe befo$e use$ inte$action
EJamp&e shell FR! &:&tartup8&eTuence
Sta$ts a she&& an eJecutes the sta$tup sc$ipt#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 76/92
Notes +he sc$ipt fi&e is not a sc$ipt in eJecute sense (as you may not useany #ey0 #b$a o$ #et an simi&a$ thin%s)#
See a&so EJecute0 Ne"She&&
S@/-
U5<*: &hutdown
Synopsis (N!A)
Location SysC
unction Shuts o"n the system an tu$n the compute$ off#
Notes Cu$$ent&y0 it "o$s on AROS4K1 une$ 7anus4UAE0 *inUAE anothe$ UAE po$ts# Othe$ a$chitectu$es sti&& nee othe$ APICcomponents to be coe0 befo$e the system "i&& be actua&&ypo"e$ab&e off#
S>
U5<*: &;ip G%ael 7+$C-9
Synopsis LABEL0 BAC1!S
Location SysC
unction Sip commans in a sc$ipt fi&e unti& a ce$tain &abe& (ec&a$e "ithLab) o$ an EnSip comman is $eache#
Inputs LABEL 44 +he &abe& to sip to#BAC1 44 Specify this if the &abe& appea$s befo$e the Sip
statement in the sc$ipt fi&e#
See a&so Lab0 EnSip
Notes S1IP BAC1 "on8t "o$ fo$ neste sc$ipts# In a sc$ipt simi&a$ to thefo&&o"in% one0 S1IP BAC1 "on8t "o$
P script 1 which launches script 2%$+ #estP do somethinB**C(#* &cript2P when &cript2 has ended
P and execution Bets ac; to &cript1
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 77/92
P do somethinB else...&-) #est +$C-
S-;
U5<*: &ort GFrom G#o 7GColstart9 7C$&*97(!*R)C9
Synopsis RO!A0+O!A0COLS+AR+!10CASE!S0NUERIC!S
Location SysC
unction So$ts the contents of a teJt fi&e
Inputs RO 44 fi&e to $ea f$om
+O 44 fi&e to output toCOLS+AR+ 44 co&umn at "hich the compa$ison be%insCASE 44 so$t is case sensiti@e# Uppe$case items a$e output fi$stNUERIC 44 &ines a$e inte$p$ete as numbe$s
EJamp&e Format rie >1: ame "!yis;"
+his "i&& fo$mat the secona$y is pa$tition (o$ a secon ha$ is)"ith the name .yis/ an "ith Sma$t i&e System#
Notes +his comman is on&y usab&e "ith teJt o$ simi&a$ fi&es (ont use onbina$y fi&es)#
S,
U5<*: &tac; 77&)Z*9 4stac; siUe59
Synopsis SI6E!N
Location SysC
unction Stac sets the efau&t stac sie of the cu$$ent She&&# +his is thestac sie of the commans $un f$om the She&&# If you use Stac"ithout a$%uments0 the cu$$ent stac sie "i&& be "$itten out#
Inputs SI6E 44 Sets the stac sie
Notes $om "ane$e$ you can set the stac sie in the info$mation"ino" of a %i@en too& icon#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 78/92
S/5
U5<*: &tatus 7Grocess9 7F(%%9 7#C+9 7C%)6$%%9 7C!6C!!$,GCom9
Synopsis PROCESS!N0ULL!S0+CB!S0CLIWALL!S0COWCOAN'!1
Location SysC
unction 'isp&ay info$mation about the p$ocesses that a$e eJecutin% "ithinShe&&s!CLIs#
Inputs PROCESS 44 P$ocess Ientification numbe$#ULL 44 'isp&ay a&& info$mation about the p$ocesses#+CB 44 As fo$ u&&0 eJcept that this option omits the p$ocess name#CLIWALL 44 'efau&t# 'isp&ays a&& p$ocesses#
COWCOAN' 44 Sho" the p$ocess i of the comman %i@en#Specify the comman name#
EJamp&e &tatus
rocess 2: %oaded as command: c:status rocess S: %oaded as command: c:ew)cons rocess K: %oaded as command: LL:&ys/%/fifo8handler rocess : %oaded as command: or;ench rocess N: %oaded as command: #oolsaemon
&tatus full
rocess 2: st; S00000 pri 0 %oaded as command: c:status
rocess S: st; K0VN pri 0 %oaded as command: c:ew)cons rocess K: st; K0VN pri 0 %oaded as command: LL:&ys/%/fifo8handler rocess : st; N000 pri 1 %oaded as command: or;ench rocess N: st; K000 pri 2 %oaded as command: #oolsaemon
T>*
U5<*: #ype IGfile 6 patternJ 7# Gname9 7# > 6 9 7>* 6 (!+*R99
Synopsis RO!A!0+O!10OP+!10-E2!S0NUBER!S
Location SysC
unction 'isp&ays content of a fi&e
Inputs RO 44 one o$ mo$e fi&es to isp&ay+O 44 p$int output to fi&eOP+ 44 - o$ N (see -E2 o$ NUBER)-E2 44 isp&ays output in heJaecima& fo$matNUBER 44 the &ines a$e numbe$e
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 79/92
EJamp&e type ac.txttype xyU.dat hex
Notes -E2 an NUBER a$e mutua&&y eJc&usi@e
U+5
U5<*: (nalias 7Gname9
Synopsis NAE!1
Location SysC
unction Remo@es a p$e@ious&y efine she&& a&ias#If no pa$amete$s a$e specifie0 the cu$$ent &ist of a&iases a$eisp&aye#
Inputs NAE 4 +he name of the a&ias to unset#
Resu&t Stana$ 'OS e$$o$ coes#
EJamp&e (nalias F
See a&so A&ias
U>,
U5<*: (npac; 7Gname9 # 7Gpath9
Synopsis ILE!A0 +O!A
Location SysC
unction Comman to unpac!una$chi@e AROS #p% fi&es#
Inputs NAE 4 +he name of the fi&e to unpac#+O T +he $i@e o$ path to be unpace#
Resu&t Stana$ 'OS e$$o$ coes#
EJamp&e (npac; $R&.p;B # Ram:
Notes +his comman is not a too& &ie &ha0 &J o$ unip# +he #p% fi&es a$enot comp$esse#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 80/92
U5*
U5<*: (nset Gname
Synopsis NAE!1
Location SysC
unction Unset a &oca& @a$iab&e
Inputs NAE 4 +he name of the &oca& @a$iab&e to unset#
Resu&t Stana$ 'OS e$$o$ coes#
See a&so Set
U5**4
U5<*: (nseten Gname
Synopsis NAE!1
Location SysC
unction Unset a %&oba& @a$iab&e
Inputs NAE 4 +he name of the %&oba& @a$iab&e to unset#
Resu&t Stana$ 'OS e$$o$ coes#
See a&so Set
U>
U5<*: unUip 78Z9 78opts7modifiers99 file7.Uip9 7list9 78x xlist978d exdir9
Synopsis COAN'S!S0O'IIERS0ILE!A
Location SysC
unction Comman to unpac!una$chi@e 6IP fi&es#
Inputs ILE 4 +he name of the fi&e to unpac#
COAN'S T +e&& Un6ip "hat to o eJact&y
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 81/92
4p eJt$act fi&es to pipe0 no messa%es4& &ist fi&es (sho$t fo$mat)4f f$eshen eJistin% fi&es0 c$eate none4t test comp$esse a$chi@e ata4u upate fi&es0 c$eate if necessa$y
4 isp&ay a$chi@e comment on&y4@ &ist @e$bose&y!sho" @e$sion info4+ timestamp a$chi@e to &atest4J eJc&ue fi&es that fo&&o" (in J&ist)4 eJt$act fi&es into eJi$
O'IIERS T pa$amete$s "hich customie eJt$action4n ne@e$ o@e$"$ite eJistin% fi&es4M Muiet moe (4MM WQ Muiete$)4o o@e$"$ite fi&es *I+-OU+ p$omptin%4a auto4con@e$t any teJt fi&es4F Fun paths (o not mae i$ecto$ies)4aa t$eat ALL fi&es as teJt4C match fi&enames case4insensiti@e&y4L mae (some) names &o"e$case4N $esto$e comments as fi&enotes4, $etain ,S @e$sion numbe$s4 pipe th$ou%h mo$e pa%e$
EJamp&es 1.sys unUip data1 8x Eoe
eJt$act a&& fi&es eJcept Foe f$om ipfi&e ata:#ip
1.sys unUip 8p foo 6 more
sen contents of foo#ip @ia pipe into p$o%$am mo$e
1.sys unUip 8fo foo Read!e
Muiet&y $ep&ace eJistin% Reae if a$chi@e fi&e ne"e$
Notes Un6ip #>> of => Ap$i& =>>;0 by Info46IP# aintaine by C# Spie&e$#
V*;5-
U5<*: Hersion 7Glirary6deice6file9 7Gersion 9 7Greision 9 7F)%*97F(%%9 7R*&9
Synopsis NAE!0'<SU!S0,ERSION!N0RE,ISION!N0ILE!S0ULL!S0RES!S
Location SysC
unction P$ints o$ checs the @e$sion an $e@ision info$mation of a fi&e0
&ib$a$y o$ e@ice#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 82/92
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 83/92
is intene#
Inputs 'W'A+E 44 *aits unti& 'A+E has been $eache+W+IE 44 *aits unti& +IE has been $eache YRWYEARS 44 -o" many yea$s to "ait
NWON+-S 44 -o" many months to "ait'YW'AYS 44 -o" many ays to "ait-W-OURS 44 -o" many hou$s to "aitWINS 44 -o" many minutes to "aitSWSECS 44 -o" many secons to "aitLWLOOP 44 -o" many times to eJecute C'LINE AWAL*AYS 44 EJecute C'LINE e@e$y set inte$@a&!time!ate ,W,ERBOSE 44 P$int eJt$a info on "hat "aitJ is oin%
Notes Base on Pub&ic 'omain *ait2 http!!aminet#net!paca%e!uti&!c&i!"aitJ P$o%$ammin% Si%bFd$n SF$et ciscc=i#netQ Iea _ 'ocs Nicho&as Sta&&a$ sno"ynetphi&e#eQ
W@,@
U5<*: hich Gfile 7R*&6R*&9 7$%%9
Synopsis ILE!A0 NORES!S0 RES!S0 ALL!S
Location SysC
unction in an p$int the &ocation of a specific p$o%$am o$ i$ecto$y#Resient p$o%$ams a$e ma$e as RESI'EN+ if they a$e notinte%$a&&y $esient in "hich case they a$e ma$e as IN+ERNAL#
*hich sea$ches the $esient &ist0 the cu$$ent i$ecto$y0 thecomman paths an the C assi%n# If the item "as not foun theconition f&a% is set to *ARN but no e$$o$ is p$inte#
Inputs ILE 44 the comman!i$ecto$y to sea$ch fo$
NORES 44 on8t inc&ue $esient p$o%$ams in the sea$chRES 44 consie$ $esient p$o%$ams on&y ALL 44 fin a&& &ocations of the ILE# +his may cause the p$intin% of the same &ocation se@e$a& times0 fo$ instance if the cu$$ent i$ecto$y is C an the ILE "as foun in C
EJamp&e hich list
See a&so Resient
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 84/92
W@
U5<*: hy
Synopsis (N!A)
Location SysC
unction P$int aitiona& info$mation "hy an ope$ation fai&e# O$ina$i&y"hen a comman fai&s a b$ief messa%e is p$inte that typica&&yinc&ues the name of the comman that fai&e but p$o@ies fe"etai&s# *hy fi&&s in etai&s $e&ate to the fai&e ope$ation#
EJamp&e ir ram:noexistinBdirCould not Bet information for ram:noexistinBdir
hy#he last command failed reason: Eect not found
See a&so au&t
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 85/92
P-5*- USB *4,*5 /+*5
AROSC i$ecto$y inc&ues too&s fo$ some USB e@ice# +hey came "ith Poseion "hen it "as po$teto AROS# *hi&e %ene$a& han&in% of USB c&asses0 e@ices an stac ha@e been a&$eay co@e$e inthe %ene$a& AROS comman $efe$ence %uie0 he$e fo&&o" the &ist of these e@ice4specific too&s an
commans#
DR-T--+
U5<*: Radio#ool
Synopsis ON!S0O!S0RE5!1!N0SCAN!S0AU+O!S0SI3NAL!S0UNI+!N!1
Location SysC
unction ,e$y simp&e she&& too& to cont$o& a USB Raio manufactu$e by '4LIN1 o$ 3em+e# On&y $aios "ith ,eno$ I' W >J>HbH anP$ouct I' W >J:>>= a$e suppo$te#
Inputs ON!S 4 tu$ns the $aio on#O!S 4 tu$ns the $aio off a%ain#RE5!1!N 4 sets the cu$$ent f$eMuency to the %i@en @a&ue# It
must be %i@en in 1- an $an%e bet"een K? - an :>K -#SCAN!S 4 sta$ts a f$eMuency scan# It sta$ts at K? -0 if no RE5
@a&ue ha been %i@en an stops at :>? -# If a $aiochanne& is etecte it "i&& output its f$eMuency in 1- on theshe&&# +he &ast foun channe& "i&& be ept# +he scan can beabo$te at any time usin% Ct$&4C#
AU+O!S 4 on&y usefu& in conFunction "ith the SCAN s"itch# If astation is foun0 the p$o%$am "i&& pause fo$ th$ee secons0asin% the use$ to p$ess Ct$&4C to eep the $aio station foun#
SI3NAL!S 4 sets the she&& $etu$n @a&ue to *ARN (<)0 if no $aiostation is etecte on the cu$$ent f$eMuency# If the$e8s aste$eo si%na&0 it "i&& $etu$n O1 (>)# +his s"itch can be use to
imp&ement a manua& scan $outine#UNI+!N!1 4 if mu&tip&e $aios a$e connecte0 you can choose the
$i%ht unit "ith this a$%ument# 'efau&ts to unit > of cou$se#
EJamp&e Radio#ool &C$ $(#
Radio#ool FR*' 10K000
P*,T--+
U5<*: encam#ool
Synopsis +O!A0PICNU!N0IN+ER,AL!N0UP+O!N!10NOBEEP!S03AA!10S-ARPEN!S0+E2+!10ON+!10ON+SI6E!N!10UNI+!N!1
Location SysC
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 86/92
unction Comman &ine too& to $ea out ima%es f$om a USB "ebcam usin%the S+,K> chip (,eno$ I' W >J><<D0 P$ouct I' W >J>=>=)#+his inc&ues the Aipte Pencam se$ies as "e&& as a fe" mo$echeap came$as out the$e# Ima%es a$e sa@e as t$ue co&ou$%$aphics in the Po$tab&e Anymap fo$mat (PP)0 see NetPB
paca%e on Aminet fo$ a &ot of con@e$sion too&s#
o$eo@e$0 %amma co$$ection an "hite ba&ance may be app&ie tothe pictu$e as "e&& as a sha$penin% fi&te$# Optiona&&y0 teJt may bepaste i$ect&y into the pictu$e usin% a use$ efinab&e font#
Inputs +O!A 4 manato$y fi&ename to sa@e the pictu$e to# +his fi&enamemay a&so contain a fo$mat st$in% such as ^& (o not fo$%et the8&8) to %ene$ate a numbe$ "hen usin% the IN+ER,AL option#
PICNU!N 4 numbe$ of the pictu$e to &oa f$om the came$a8s RA0sta$tin% "ith > fo$ the fi$st pictu$e# If no pictu$e eJist "ith thisnumbe$0 you "i&& %et %a$ba%e# Omittin% this pa$amete$ "i&& tae acu$$ent snapshot#
IN+ER,AL!N 4 if this nume$ic pa$amete$ is %i@en0 Pencam+oo& "i&&&oop an tae pictu$es at the %i@en inte$@a& (in tics0 <> tics isone secon)# Inte$@a& is on&y sensib&e0 if you on8t use the
PICNU a$%ument# Use Ct$&4C to abo$t the Pencam+oo&#UP+O!N!1 4 if specifie0 mu&tip&e pictu$es can be %$abbe in one
%o0 sta$tin% at the PICNU numbe$ an stoppin% at the UP+Onumbe$# Be su$e to %i@e a fo$mat st$in% such as ^& insie thefi&ename o$ you "i&& "$ite a&& pictu$es to the same ima%e# If no
PICNU is %i@en0 but IN+ER,AL instea0 UP+O esc$ibes the ima%enumbe$ to stop the $e%u&a$ pictu$e tain%#
NOBEEP!S 4 isab&e BEEP on o"n&oain% an ima%e#3AA!1 4 enab&e "hite ba&ance an %amma co$$ection "ith the%i@en f&oatin% point %amma @a&ue# >#H< is a %oo settin%# If youon&y "ant "hite ba&ance an no %amma co$$ection0 use a @a&ue of:#>#
S-ARPEN!S 4 app&y a hi%h&y optimie <J< sha$pen fi&te$ on the I ma%e#+E2+!1 4 optiona&&y as the %i@en &ine of teJt to the bottom of thepictu$e# If the &ine is too &on% to fit0 it "i&& be t$uncate#
ON+!1 4 name of the font to use (e#%# Jen#font)# If this pa$amete$is missin%0 the efau&t system font "i&& be use#
ON+SI6E!N!1 4 sie of the font in piJe&sUNI+!N!1 4 if se@e$a& came$as a$e connecte0 specify the unit touse# 'efau&ts to unit >#
EJamp&e encam#ool &nap.ppm encam#ool &nap.ppm 0 L$!!$ 0.K &>$R* encam#ool !oieX0Kld.ppm )#*RH$% 0 L$!!$ 0. encam#ool ecam.ppm L$!!$ 0.K &>$R* #*#"latonYs Cam" F# small.font F#&)Z* N +** encam#ool &hotseriesX0Sld.ppm 0 (# WV L$!!$ 0.K&>$R*
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 87/92
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 88/92
R-,*T--+
U5<*: Roc;et#ool
Synopsis LE+!S0RI3-+!S0UP!S0'O*N!S0IRE!S0+IE!N!107OYPOR+!N!10UNI+!N!1
Location SysC
unction ,e$y simp&e she&& too& to cont$o& a USB Rocet o$ issi&e Launche$a@ai&ab&e f$om @a$ious sou$ces on the inte$net# On&y "eapons ofmass est$uction "ith ,eno$ I' W >J::D> an P$ouct I' W>J>=>= a$e suppo$te#
Note that the e@ices "i&& mistaen&y $epo$t as -I' e@ice0 but theyon8t actua&&y spea -I' confo$mant commans ("hich is a pity)#
On the fi$st &aunch of Rocet+oo&0 any -I' binin% "i&& be$emo@e automatica&&y#
Inputs LE+!S 4 tu$n the $ocet pa to the &eft fo$ some time#RI3-+!S 4 tu$n the $ocet pa to the $i%ht fo$ some time#UP!S 4 chan%e the pitch up#'O*N!S 4 aim &o"e$#IRE!S 4 &aunch one of the th$ee missi&es#+IE!N!1 4 optiona&&y %i@e the time of the mo@ement in tics (onetic is :!<>sec)#7OYPOR+!N!1 4 instea of %i@in% the i$ection0 connect cont$o&s to
the Foystic o$ Foypa at the %i@en po$t# Of cou$se0 you can a&so usea USB Foypa fo$ this Fob# +o eJit0 p$ess Ct$&4C#UNI+!N!1 4 if mu&tip&e $ocet &aunche$s a$e connecte0 you canchoose the $i%ht unit "ith this a$%ument# 'efau&ts to unit > ofcou$se#
EJamp&es Roc;et#ool %*F# #)!* 100
Roc;et#ool R)L># ( 0 F)R*
Roc;et#ool F)R*
Roc;et#ool Q<R# 1
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 89/92
APEN'I2 I T P$inte$ Escape SeMuences (o$ commans)
o$ eJamp&e
T*= I+,5EJamp&e Echo E[DmIta&icsE[=DmPu$pose E[Dm tu$ns on ita&ics an E[=Dm tu$ns off ita&ics
T*= B-+EJamp&e Echo E[:mBo&E[==mPu$pose E[:m tu$ns on bo&0 an E[==m tu$ns off bo&#
U*;+* T*=
EJamp&e Echo E[HmUne$&ineE[=HmPu$pose E[Hm tu$ns on une$&ine0 an E=Hm tu$ns off une$&ine#
C-+-/;* T*=EJamp&e Echo E[D=mRe +eJtE[>mPu$pose E[nm "he$e nWD>4D; fo$ fo$e%$oun co&o$ o$ nWH>4H; fo$ bac%$oun co&ou$#E[>m $esets to no$ma& cha$acte$ set#
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 90/92
AppeniJ II T AROS4'OS E$$o$ messa%es
D*5,;>- D*5,;>-
:>D not enou%h memo$y a@ai&ab&e =:; see fai&u$e:>< p$ocess tab&e fu&& ==> comment is too &on%::H ba temp&ate ==: is is fu&&::< ba numbe$ === obFect is p$otecte f$om e&etion:: $eMui$e a$%ument missin% ==D fi&e is "$ite p$otecte::? @a&ue afte$ ey"o$ missin% ==H fi&e is $ea p$otecte::K "$on% numbe$ of a$%uments ==< not a @a&i 'OS is ::; unmatche Muotes == no is in $i@e:=> a$%ument &ine in@a&i o$ too &on% =D= no mo$e ent$ies in i$ecto$y:=: fi&e is not eJecutab&e =DD obFect is soft &in
:== in@a&i $esient &ib$a$y =DH obFect is &ine=>= obFect is in use =D< ba &oafi&e hun =>D obFect a&$eay eJists =D function not imp&emente=>H i$ecto$y not foun =H> $eco$ not &oce=>< obFect not foun =H: $eco$ &oc co&&ision=> in@a&i "ino" esc$iption =H= $eco$ &oc timeout=>? obFect too &a$%e =HD $eco$ un&oc e$$o$
=>; pacet $eMuest type unno"n D>D buffe$ o@e$f&o"
=:> obFect name in@a&i D>H B$ea =:: in@a&i obFect &oc D>< fi&e not eJecutab&e
=:= obFect is not of $eMui$e type
=:D is is not @a&iate
=:H is is "$ite4p$otecte
=:< $ename ac$oss e@ices attempte
=: i$ecto$y not empty
=:? too many &e@e&s
=:K e@ice (o$ @o&ume) is not mounte
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 91/92
8/12/2019 Aros Shell Manual 0.80
http://slidepdf.com/reader/full/aros-shell-manual-080 92/92