Editing AmigaDOS

{{About-distinguish-text|the disk operating system portion of the OS|the similarly-named OS itself, [[AmigaOS]]}}
{{Short description|Disk operating system of the AmigaOS}}
{{Refimprove|date=July 2009}}
{{Infobox OS
| name = AmigaDOS
| logo = 
| logo_size = 
| screenshot = 
| caption = 
| developer = [[Amiga Corporation]]
| family = [[TRIPOS]]
| released = {{Start date and age|1985}}
| discontinued = yes
| influenced_by = 
| ui = [[Command-line interface]]
| license = [[Proprietary software|Proprietary]]
| website = 
| source_model = [[Closed source]]
| kernel_type = 
| succeeded_by = 
| supported_platforms = 
| latest_release_version = 
| latest_release_date = 
| programmed_in = AmigaOS 1.x: [[BCPL]]<br />AmigaOS 2.x onwards: [[C (programming language)|C]]
| updatemodel = 
| package_manager = 
| working_state = 
| support_status = 
}}
'''AmigaDOS''' is the [[disk operating system]] of the [[AmigaOS]], which includes [[file system]]s, file and directory manipulation, the [[command-line interface]], and file [[Redirection (computing)|redirection]].

In AmigaOS 1.x, AmigaDOS is based on a [[TRIPOS]] port by [[MetaComCo]], written in [[BCPL]]. BCPL does not use native [[pointer (computer programming)|pointer]]s, so the more advanced functionality of the operating system was difficult to use and error-prone. The third-party ''AmigaDOS Resource Project''<ref>{{cite web|url=http://uk.aminet.net/misc/antiq/ARP_13.readme |title=The AmigaDOS Resource Project |access-date=2006-07-18 |url-status=dead |archive-url=https://web.archive.org/web/20070311015022/http://uk.aminet.net/misc/antiq/ARP_13.readme |archive-date=2007-03-11 }}</ref> (ARP, formerly the ''AmigaDOS Replacement Project''),<ref>{{Cite web|url=http://ftp.funet.fi/pub/amiga/ancient/ex-amiga-s/archive/|title = Index of /Pub/Amiga/Ancient/Ex-amiga-s/Archive}}</ref> a project begun by Amiga developer Charlie Heath, replaced many of the BCPL utilities with smaller, more sophisticated equivalents written in [[C (programming language)|C]] and [[assembly language|assembler]], and provided a [[wrapper library]], <code>arp.library</code>. This eliminated the interfacing problems in applications by automatically performing conversions from native pointers (such as those used by C or assembler) to BCPL equivalents and vice versa for all AmigaDOS functions.

From AmigaOS 2.x onwards, AmigaDOS was rewritten in C, retaining 1.x compatibility where possible. Starting with AmigaOS 4, AmigaDOS abandoned its legacy with BCPL. Starting from AmigaOS 4.1, AmigaDOS has been extended with [[64-bit computing|64-bit]] file-access support.

==Console==
The Amiga console is a standard Amiga [[virtual device]], normally assigned to ''CON:'' and driven by ''console.handler''. It was developed from a primitive interface in AmigaOS 1.1, and became stable with versions 1.2 and 1.3, when it started to be known as AmigaShell and its original handler was replaced by ''newconsole.handler'' (''NEWCON:'').

The console has various features that were considered up to date when it was created in 1985, like command template help, redirection to null ("'''NIL:'''"), and [[ANSI]] color terminal. The new console handler – which was implemented in release 1.2 – allows many more features, such as [[command history]], [[pipeline (Unix)|pipelines]], and automatic creation of files when output is [[redirection (computing)|redirected]]. When [[TCP/IP stack]]s like AmiTCP were released in the early 1990s, the console could also receive redirection from Internet-enabled Amiga device handlers (e.g., ''TCP:'', {{mono|copy file TO TCP:Site/Port}}).

Unlike other systems originally launched in the mid-1980s, AmigaDOS does not implement a proprietary character set; the developers chose to use the ANSI–[[International Organization for Standardization|ISO]] standard [[ISO-8859-1|ISO-8859-1 (Latin 1)]], which includes the [[ASCII]] character set. As in [[Unix]] systems, the Amiga console accepts only linefeed ("[[Line feed|LF]]") as an end-of-line ("[[Newline|EOL]]") character. The Amiga console has support for [[accented characters]] as well as for characters created by combinations of 'dead keys' on the keyboard.

==Syntax of AmigaDOS commands==
This is an example of typical AmigaDOS command syntax:

<syntaxhighlight lang="doscon">
1> Dir DF0:
</syntaxhighlight>

:Without entering the directory tree, this shows the content of a directory of a floppy disk and lists [[subdirectories]] as well.

<syntaxhighlight lang="doscon">
1> Dir SYS: ALL
</syntaxhighlight>

:The argument "''ALL''" causes the command to show the entire content of a volume or device, entering and expanding all directory trees. "''SYS:''" is a default name that is assigned to the boot device, regardless of its physical name.<ref>{{harvnb|Commodore-Amiga Inc.|1986}}</ref>

===Command redirection===
AmigaDOS can redirect the output of a command to files, pipes, a printer, the null device, and other Amiga devices.

<syntaxhighlight lang="doscon">
1> Dir > SPEAK: ALL
</syntaxhighlight>

:Redirects the output of the "''dir''" command to the speech synthesis handler. The colon character "'':''" indicates that ''SPEAK:'' points to an AmigaDOS device. While a typical use for a device is [[file system]]s, special-purpose device names such as this are commonly used in the system.

===Command template===
AmigaDOS commands are expected to provide a standard "template" that describes the arguments they can accept. This can be used as a basic "help" feature for commands, although third-party replacement console handlers and [[Shell (computing)|shells]], such as [[Bash (Unix shell)|Bash]] or [[Zshell]] (ported from [[Unix]]), or KingCON often provide more verbose help for built-in commands.

On requesting the template for the command "''Copy''", the following output is obtained:

<syntaxhighlight lang="doscon">
1> Copy ?
   FROM, TO/A, ALL/S, QUIET/S
</syntaxhighlight>

:This [[string (computer science)|string]] means that the user must use this command in conjunction with ''FROM'' and ''TO'' arguments, where the latter is compulsory ({{mono|/A}}). The argument keywords ''ALL'' and ''QUIET'' are switches ({{mono|/S}}) and change the results of the command ''Copy'' (''ALL'' causes all files in a directory to be copied, while ''QUIET'' will cause the command to generate no output).

By reading this template, a user can know that the following syntax is acceptable for the command:

<syntaxhighlight lang="doscon">
1> Copy DF0:Filename TO DH0:Directory/Filename
</syntaxhighlight>

===Breaking commands and pausing console output===
A user can terminate a program by invoking the key combination {{keypress|Ctrl|C}} or {{keypress|Ctrl|D}}. Pressing {{keypress|space}} or any printing character on the keyboard suspends the console output. Output may be resumed by pressing the {{keypress|backspace}} key (to delete all of the input) or by pressing {{keypress|enter}} (which will cause the input to be processed as a command as soon as the current command stops running).

===Wildcard characters===
Like other operating systems, AmigaDOS also provides [[wildcard character]]s that are substitutes for any character or any sequence of random characters in a string. Here is an example of wildcard characters in AmigaDOS commands:

<syntaxhighlight lang="doscon">
1> Dir #?.info
</syntaxhighlight>

:searches the current directory for any file containing ".info" at its end as suffix, and displays only these files in the output.

The parsing of this is as follows. The "?" wildcard indicates "any character". Prefixing this with a "#" indicates "any number of repetitions". This can be viewed as analogous to the [[regular expression]] ".*".

==Scripting==
AmigaDOS also has the feature of dealing with [[Batch file|batch]] programming, which it calls "script" programming, and has a number of commands such as <syntaxhighlight lang="doscon" inline>Echo</syntaxhighlight>, <syntaxhighlight lang="doscon" inline>If</syntaxhighlight>, <syntaxhighlight lang="doscon" inline>Then</syntaxhighlight>, <syntaxhighlight lang="doscon" inline>EndIf</syntaxhighlight>, <syntaxhighlight lang="doscon" inline>Val</syntaxhighlight>, and <syntaxhighlight lang="doscon" inline>Skip</syntaxhighlight> to deal with structured script programming. Scripts are text-based files and can be created with AmigaDOS's internal text editor program, called '''Ed''' (unrelated to Unix's [[Ed (text editor)|Ed]]), or with any other third-party text editor. To invoke a script program, AmigaDOS uses the command <syntaxhighlight lang="doscon" inline>Execute</syntaxhighlight>.

<syntaxhighlight lang="doscon">
1> Execute myscript
</syntaxhighlight>

This executes the script called "myscript".

This method of executing scripts keeps the console window busy until the script has finished its scheduled job. Users cannot interact with the console window until the script ends or until they interrupt it.

While:
<syntaxhighlight lang="doscon">
1> Run Execute myscript
</syntaxhighlight>

The AmigaDOS command <syntaxhighlight lang="doscon" inline>Run</syntaxhighlight> executes any DOS command or any kind of program and keeps the console free for further input.

===Protection bits===
Protection bits are flags that files, links and directories have in the filesystem. To change them one can either use the command '''Protect''', or use the '''Information''' entry from the '''Icons''' menu in Workbench on selected files. AmigaDOS supports the following set of protection bits (abbreviated as HSPARWED):
*H = Hold (reentrant commands with the P-bit set will automatically become resident on first execution. Requires E, P and R bits set to work. Does ''not'' mean "Hide". See below.)
*S = Script (Batch file. Requires E and R bits set to work.) If this protection bit is set on, then AmigaDOS is able to recognize and automatically run a script by simply invoking its name. Without S bit scripts can still be launched using the <syntaxhighlight lang="doscon" inline>Execute</syntaxhighlight> command.
*P = Pure (indicates reentrant commands that can be made resident in RAM and then no longer need to be loaded any time from [[flash drives]], [[hard disks]] or any other media device. Requires E and R bits set to work.)
*A = Archive (Archived bit, used by various backup programs to indicate that a file has been backed up)
*R = Read (Permission to read the file, link or content of directory)
*W = Write (Permission to write the file, link or inside a directory)
*E = Execute (Permission to execute the file or enter the directory. All commands need this bit set, or they won't run. Requires R bit set to work.)
*D = Delete (Permission to delete the file, link or directory)

The H-bit has often been misunderstood to mean "Hide". In [[Smart File System]] (SFS) files and directories with H-bit set are hidden from the system. It is still possible access hidden files but they don't appear in any directory listings.

Demonstration of H-bit in action:
<syntaxhighlight lang="doscon">
AmigaPrompt> which list
Workbench:C/List
AmigaPrompt> list workbench:c/list
Directory "workbench:c" on Thursday 30-Oct-08
list                              6464 --p-rwed 25-Feb-02 22:30:00
1 file - 14 blocks used
AmigaPrompt> which list
Workbench:C/List
AmigaPrompt> protect workbench:c/list +h
AmigaPrompt> which list
Workbench:C/List
AmigaPrompt> list workbench:c/list
Directory "workbench:c" on Thursday 30-Oct-08
list                              6464 h-p-rwed 25-Feb-02 22:30:00
1 file - 14 blocks used
AmigaPrompt> which list
RES list
</syntaxhighlight>

:Notice how the '''list''' command becomes resident after execution when the H-bit is set.

===Local and global variables===
As any other DOS, Amiga deals with [[Variable (computer science)|environment variables]] as used in batch programming.

There are both global and local variables, and they are referred to with a dollar sign in front of the variable name, for example '''$myvar'''. Global variables are available system-wide; local variables are only valid in the current shell. In case of name collision, local variables have precedence over global variables. Global variables can be set using the command '''SetEnv''', while local variables can be set using the command '''Set'''. There are also the commands '''GetEnv''' and '''Get''' that can be used to print out global and local variables.

The examples below demonstrate simple usage:

<syntaxhighlight lang="doscon">
1> setenv foo blapp
1> echo $foo
blapp
1> set foo bar
1> echo $foo
bar
1> getenv foo
blapp
1> get foo
bar
1> type ENV:foo
blapp
1> setenv save foo $foo
1> type ENV:foo
bar
1> type ENVARC:foo
bar
</syntaxhighlight>
: If the <syntaxhighlight lang="doscon" inline>save</syntaxhighlight> flag of the <syntaxhighlight lang="doscon" inline>SetEnv</syntaxhighlight> command is set, this variable is saved permanently in <syntaxhighlight lang="doscon" inline>ENVARC:</syntaxhighlight> and remains available even after the current session has ended or the system has been restarted.

Global variables are kept as files in '''ENV:''', and optionally saved on disk in '''ENVARC:''' to survive reboot and [[power cycling]]. '''ENV:''' is by default an assign to RAM:Env, and ENVARC: is an assign to '''SYS:Prefs/Env-archive''' where SYS: refers to the [[Booting#Boot_device|boot device]]. On bootup, the content of ENVARC: is copied to ENV: for accessibility.

When programming AmigaDOS scripts, one must keep in mind that global variables are system-wide. All script-internal variables shall be set using local variables, or one risks conflicts over global variables between scripts. Also, global variables require filesystem access, which typically makes them slower to access than local variables.

Since ENVARC: is also used to store other system settings than just string variables (such as system settings, default icons and more), it tends to grow large over time, and copying everything over to ENV: located on RAM disk becomes expensive. This has led to alternative ways to set up ENV: by using dedicated [[ramdisk]] handlers that only copy files over from ENVARC: when the files are requested. Examples of such handlers are <ref>{{cite web|url=http://aminet.net/package/disk/misc/HappyENV |title=disk/misc/HappyENV.lha |publisher=Aminet |access-date=2016-07-15}}</ref> and.<ref>{{cite web|url=http://aminet.net/package/util/sys/envhandler |title=util/sys/envhandler.lha |publisher=Aminet |access-date=2016-07-15}}</ref> 

An example demonstrating creative abuse of global variables as well as '''Lab''' and '''Skip''' is the AmigaDOS variant of the infamous [[GOTO]].<ref>{{cite web|url=http://www.safalra.com/programming/amigados/universal-register-machine/|title=Code by Stephen Morley|access-date=April 5, 2016}}</ref>

==Case sensitivity==
AmigaDOS is in general [[Case sensitivity|case-insensitive]].<ref>{{cite book|page=549|isbn=978-1-55558-164-0|title=Using C-Kermit: Communication Software|last1=Cruz|first1=Frank da|last2=Gianone|first2=Christine|year=1997}}</ref> Indicating a device as "Dh0:", "DH0:" or "dh0:" always refers to the same [[disk partitioning|partition]]; however, for file and directory names, this is filesystem-dependent, and some filesystems allow case sensitivity as a flag upon formatting. An example of such a file system is [[Smart File System]]. This is very convenient when dealing with software [[porting|ported]] over from the mostly case-sensitive [[Unix-like|Un*x]] world, but causes much confusion for native Amiga applications, which assume case insensitivity. Advanced users will hence typically only use the case sensitivity flag for file systems used for software originating from Un*x.

Re-casing of file, directory and volume names is allowed using ordinary methods; the commands "rename foo Foo" and "relabel Bar: bAr:" are valid and do exactly what is expected, in contrast to for example on [[Linux]], where "mv foo Foo" results in the error message "mv: `foo' and `Foo' are the same file" on case-insensitive filesystems like [[File Allocation Table|VFAT]].

==Volume naming conventions==
Partitions and physical drives are typically referred to as ''DF0:'' (floppy drive 0), ''DH0:'' (hard drive 0), etc.  However, unlike many operating systems, outside of built-in physical hardware devices like ''DF0:'' or ''HD0:'', the names of the single disks, volumes and partitions are totally arbitrary: for example a hard disk partition could be named ''Work'' or ''System'', or anything else at the time of its creation. Volume names can be used in place of the corresponding device names, so a disk partition on device ''DH0:'' called ''Workbench'' could be accessed either with the name ''DH0:'' or ''Workbench:''. Users must indicate to the system that "''Workbench''" is the volume "''Workbench:''" by always typing the colon "'':''" when they are entering information in a requester form or into AmigaShell.

If an accessed volume name cannot be found, the operating system will prompt the user to insert the disk with the given volume name, or allow the user to cancel the operation.

In addition, logical device names can be set with the "assign" command to any directory or device; programs often assigned a virtual volume name to their installation directory (for instance, a fictional word processor called ''Writer'' might assign ''Writer:'' to ''DH0:Productivity/Writer''). This allows for easy relocation of installed programs. The default name ''SYS:'' is used to refer to the volume that the system was booted from. Various other default names are provided to refer to important system locations. e.g. ''S:'' for startup scripts, ''C:'' for AmigaDOS commands, ''FONTS:'' for installed fonts, etc.

Assignment of volume labels can also be set on multiple directories, which will be treated as a union of their contents. For example, ''FONTS:'' might be assigned to ''SYS:Fonts'', then extended to include, for example, ''Work:UserFonts'' using the ''add'' option of the AmigaDos ''assign'' command. The system would then permit use of fonts installed in either directory. Listing ''FONTS:'' would show the files from both locations.

==Conventions of names and typical behaviour of virtual devices==
The physical device {{mono|DF0:}} shares the same floppy drive mechanics with {{mono|PC0:}}, which is the CrossDOS virtual device capable of reading PC formatted floppy disks. When any PC formatted floppy disk is inserted into the floppy drive, then the {{mono|DF0:}} floppy Amiga icon will change to indicate that the disk is unknown to the normal Amiga device, and it will show four question marks {{mono|????}} as the standard "unknown" volume name, while the {{mono|PC0:}} icon will appear revealing the name of the PC formatted disk. Any disk change with Amiga formatted disks will invert this behaviour.

== File systems ==
AmigaDOS supports various filesystems and variants. The first filesystem was simply called [[Amiga Old File System|Amiga FileSystem]], and was suitable mainly for floppy disks, because it did not support automatic booting from hard disks (on floppy, booting was done using code from the bootblock). It was soon replaced by [[Amiga Fast File System|FastFileSystem]] (FFS), and hence the original filesystem was known by the name of "Old" FileSystem (OFS). FFS was more efficient on space and quite measurably faster than OFS, hence the name.

With AmigaOS 2.x, FFS became an official part of the OS and was soon expanded to recognise cached partitions, international partitions allowing accented characters in file and partition names, and finally (with [[MorphOS]] and [[AmigaOS 4]]) long filenames, up to 108 characters (from 31).

Both AmigaOS 4.x and MorphOS featured a new version of FFS called FastFileSystem 2. FFS2 incorporated all of the features of the original FFS including, as its author put it, "some minor changes". In order to preserve backwards compatibility, there were no major structural changes. (However, FF2 on [[AmigaOS 4.1]] differs in that it can expand its features and capabilities with the aid of [[plug-in (computing)|plug-ins]]). As with FFS2, the AmigaOS 4 and MorphOS version of Smart FileSystem is a fork of original SFS and are not 100% compatible with it.

Other filesystems like [[FAT12]], [[FAT16]], [[FAT32]] from Windows or [[ext2]] from Linux are available through easily installable ([[drag and drop]]) system libraries or third party modules such as FAT95 <ref>{{cite web|url=http://aminet.net/package/disk/misc/fat95 |title=disk/misc/fat95.lha |publisher=Aminet |access-date=2016-07-15}}</ref> (features read/write support), which can be found on the [[Aminet]] software repository. MorphOS 2 has built-in support for FAT filesystems.

[[AmigaOS 4.1]] adopted a new filesystem called JXFS capable to support partitions over a [[terabyte]] of size.

Alternate filesystems from third-party manufacturers include [[Professional File System|Professional FileSystem]], which is a filesystem with an easy structure, based on [[metadata]], allowing high internal coherence, capable of [[defragmenting]] itself on the fly, and does not require to be unmounted before being [[mount (computing)|mounted]] again; and [[Smart File System|Smart FileSystem]] which is a [[journaling file system|journaling]] filesystem which performs journaled activities during system inactivities, and has been chosen by MorphOS as its standard filesystem.

=== Official variants of Amiga filesystems ===
'''Old File System'''/'''Fast File System'''
*OFS (DOS0)
*FFS (DOS1)
*OFS International (DOS2)
*FFS International (DOS3)
*OFS Directory Caching (DOS4)
*FFS Directory Caching (DOS5)

'''Fast File System 2 (AmigaOS4.x/MorphOS)'''
* OFS Long filenames (DOS6)
* FFS Long filenames (DOS7)

Both DOS6 and DOS7 feature International filenames featured in DOS2 and DO3, but not Directory Caching, which was abandoned due to bugs in the original implementation. DOS4 and DOS5 are not recommended for use for this reason.

Dostypes are [[backwards compatible]] with each other, but not [[forward compatible]]. A DOS7 formatted disk cannot be read on original Amiga FFS, and a DOS3 disk cannot be read on a KS1.3 Amiga. However, any disk formatted with DOS0 using FFS or FFS2 can be read by any version of the Amiga operating system. For this reason, DOS0 tended to be the format of choice of software developers distributing on floppy, except where a custom filesystem and bootblock was used - a common practice in Amiga games. Where software needed AmigaOS 2 anyway, DOS3 was generally used.

=== FastFileSystem2 plug-ins ===
With the July 2007 Update of [[AmigaOS 4.0]] in 2007, the first two plug-ins for FFS2 were released:
* '''fs_plugin_cache''': increases performance of FFS2 by introducing a new method of data buffering.
* '''fs_plugin_encrypt''': data encryption plug-in for partitions using the [[Blowfish (cipher)|Blowfish]] algorithm.

==Filename extensions==
AmigaDOS has only a single mandated filename extension: ".info", which must be appended to the filename of each icon. If a file called '''myprog''' exists, then its icon file must be called '''myprog.info'''. In addition to image data, the icon file also records program [[metadata]] such as options and keywords, its own position on the desktop (AmigaOS can "snapshot" icons in places defined by the user), and other information about the file. Directory window size and position information is stored in the ".info" file associated with the directory, and disk icon information is stored in "Disk.info" in the root of the volume.

With the exception of icons, the Amiga system does not identify file types using extensions, but instead will examine either the icon associated with a file or the binary [[header (computing)|header]] of the file itself to determine the file type.

==See also==
{{Portal|Amiga}}
* [[Comparison of operating systems]]

==References==
{{Reflist}}

==Further reading==
* {{cite book|author=Commodore-Amiga Inc.|title=The AmigaDOS User's Manual|publisher=Bantam Computer|year=1986|isbn=0-553-34294-0|url=https://archive.org/details/TheAmigaDOSUsersManual3In1Manual|language=en}}
* {{cite book|author=Commodore-Amiga Inc.|title=The AmigaDOS Manual, Third Edition |publisher=Bantam Computer|year=1991|isbn=0-553-35403-5|url=https://archive.org/details/TheAmigaDOSUsersManual3In1Manual|language=en}}

==External links==
*{{cite web|author=Tim King |url=http://www.tim-king.com/amiga.html |title=Amiga History |website=Tim-king.com |access-date=2016-07-15}}
*{{cite web|author=Tim King |url=http://www.tim-king.com/cv.html |title=CV |publisher=Tim King |access-date=2016-07-15}}

{{AmigaOS}}
{{Disk operating systems}}

{{DEFAULTSORT:Amigados}}
[[Category:AmigaOS]]
[[Category:Disk operating systems]]
[[Category:MorphOS]]
[[Category:1985 software]]