Aros Shell Manual 0.80

92
AROS Shell Manual

Transcript of Aros Shell Manual 0.80

Page 1: 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

Page 2: Aros Shell Manual 0.80

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#

Page 3: Aros Shell Manual 0.80

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######################################################################################################################=; 

Page 4: Aros Shell Manual 0.80

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#################################################################################################################= 

Page 5: Aros Shell Manual 0.80

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

Page 6: Aros Shell Manual 0.80

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#

Page 7: Aros Shell Manual 0.80

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$%!#

 

Page 8: Aros Shell Manual 0.80

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#

Page 9: Aros Shell Manual 0.80

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 =#

Page 10: Aros Shell Manual 0.80

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#

Page 11: Aros Shell Manual 0.80

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$#

Page 12: Aros Shell Manual 0.80

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

Page 13: Aros Shell Manual 0.80

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:

Page 14: Aros Shell Manual 0.80

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#

Page 15: Aros Shell Manual 0.80

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

Page 16: Aros Shell Manual 0.80

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#

Page 17: Aros Shell Manual 0.80

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#

Page 18: Aros Shell Manual 0.80

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#

Page 19: Aros Shell Manual 0.80

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#

Page 20: Aros Shell Manual 0.80

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

Page 21: Aros Shell Manual 0.80

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#

Page 22: Aros Shell Manual 0.80

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#

Page 23: Aros Shell Manual 0.80

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

Page 24: Aros Shell Manual 0.80

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

Page 25: Aros Shell Manual 0.80

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%)&#9 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

Page 26: Aros Shell Manual 0.80

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)#

Page 27: Aros Shell Manual 0.80

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

Page 28: Aros Shell Manual 0.80

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

Page 29: Aros Shell Manual 0.80

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)#

Page 30: Aros Shell Manual 0.80

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

Page 31: Aros Shell Manual 0.80

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#

Page 32: Aros Shell Manual 0.80

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#

Page 33: Aros Shell Manual 0.80

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#

Page 34: Aros Shell Manual 0.80

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#

Page 35: Aros Shell Manual 0.80

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

Page 36: Aros Shell Manual 0.80

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#

Page 37: Aros Shell Manual 0.80

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

Page 38: Aros Shell Manual 0.80

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#

Page 39: Aros Shell Manual 0.80

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)#

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

Page 40: Aros Shell Manual 0.80

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 !

Page 41: Aros Shell Manual 0.80

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

Page 42: Aros Shell Manual 0.80

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#

Page 43: Aros Shell Manual 0.80

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

Page 44: Aros Shell Manual 0.80

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

Page 45: Aros Shell Manual 0.80

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

Page 46: Aros Shell Manual 0.80

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

Page 47: Aros Shell Manual 0.80

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#

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

Page 48: Aros Shell Manual 0.80

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

Page 49: Aros Shell Manual 0.80

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

Page 50: Aros Shell Manual 0.80

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

Page 51: Aros Shell Manual 0.80

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

Page 52: Aros Shell Manual 0.80

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$

Page 53: Aros Shell Manual 0.80

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

Page 54: Aros Shell Manual 0.80

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$#

Page 55: Aros Shell Manual 0.80

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#

Page 56: Aros Shell Manual 0.80

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

Page 57: Aros Shell Manual 0.80

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#

Page 58: Aros Shell Manual 0.80

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

Page 59: Aros Shell Manual 0.80

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

Page 60: Aros Shell Manual 0.80

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

Page 61: Aros Shell Manual 0.80

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

Page 62: Aros Shell Manual 0.80

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#

Page 63: Aros Shell Manual 0.80

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

Page 64: Aros Shell Manual 0.80

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

Page 65: Aros Shell Manual 0.80

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#

Page 66: Aros Shell Manual 0.80

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#

Page 67: Aros Shell Manual 0.80

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$

Page 68: Aros Shell Manual 0.80

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&)&#9 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

Page 69: Aros Shell Manual 0.80

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

Page 70: Aros Shell Manual 0.80

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

Page 71: Aros Shell Manual 0.80

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$#

Page 72: Aros Shell Manual 0.80

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&)

Page 73: Aros Shell Manual 0.80

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@#

Page 74: Aros Shell Manual 0.80

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#

Page 75: Aros Shell Manual 0.80

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#

Page 76: Aros Shell Manual 0.80

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

Page 77: Aros Shell Manual 0.80

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#

Page 78: Aros Shell Manual 0.80

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

 

Page 79: Aros Shell Manual 0.80

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#

Page 80: Aros Shell Manual 0.80

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

Page 81: Aros Shell Manual 0.80

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#

Page 82: Aros Shell Manual 0.80

8/12/2019 Aros Shell Manual 0.80

http://slidepdf.com/reader/full/aros-shell-manual-080 82/92

Page 83: Aros Shell Manual 0.80

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

Page 84: Aros Shell Manual 0.80

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

Page 85: Aros Shell Manual 0.80

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

Page 86: Aros Shell Manual 0.80

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*

Page 87: Aros Shell Manual 0.80

8/12/2019 Aros Shell Manual 0.80

http://slidepdf.com/reader/full/aros-shell-manual-080 87/92

Page 88: Aros Shell Manual 0.80

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

Page 89: Aros Shell Manual 0.80

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#

Page 90: Aros Shell Manual 0.80

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

Page 91: Aros Shell Manual 0.80

8/12/2019 Aros Shell Manual 0.80

http://slidepdf.com/reader/full/aros-shell-manual-080 91/92

Page 92: Aros Shell Manual 0.80

8/12/2019 Aros Shell Manual 0.80

http://slidepdf.com/reader/full/aros-shell-manual-080 92/92