The file: URI is a URI scheme specified in RFC 1630 and RFC 1738, typically used to retrieve files from within one's own computer.

Contents 1 Format 2 Meaning of slash character 3 Examples 3.1 Linux 3.2 Windows 3.3 Things to consider 3.3.1 Windows 3.3.2 Web pages 3.3.3 Mozilla 3.3.4 Internet Explorer 3.3.5 Other 4 External links

[edit] Format

A file: URI takes the form of

 file://host/path 

where host is the fully qualified domain name of the system on which the path is accessible, and path is a hierarchical directory path of the form directory/directory/.../name. If host is omitted, it is taken to be "localhost", the machine from which the URL is being interpreted. Note that when omitting host you do not omit the slash ("file:///foo.bar" is ok, while "file://foo.bar" is not, no matter some interpreters manage to handle the latter. )

[edit] Meaning of slash character

The slash character (/), depending on its position, is used in different meanings in a file URL.

• The // after the file: is part of the general syntax of URLs. (The double slash // should always appear in a file URL according to the specification, but in practice many Web browsers allow you to omit it, in some cases at least.)
• The single slash between host and path is part of the syntax of file URLs.
• And the slashes in path separate directory names in a hierarchical system of directories and subdirectories. In this usage, the slash is a general, system-independent way of separating the parts, and in a particular host system it might be used as such in a pathname (as in Unix systems).

[edit] Examples

[edit] Linux

Here are two linux examples pointing to the same /etc/fstab file:

 file://localhost/etc/fstab file:///etc/fstab 

[edit] Windows

Here are some examples valid for Windows systems, referring to the same file c:\WINDOWS\clock.avi

 file://localhost/c|/WINDOWS/clock.avi file:///c|/WINDOWS/clock.avi file://localhost/c:/WINDOWS/clock.avi file:///c:/WINDOWS/clock.avi 

While the last is the most obvious and human-readable, the first one is the most complete and correct one.

[edit] Things to consider

[edit] Windows

On MS Windows systems, the normal colon (:) after a device letter has sometimes been replaced by a vertical bar (|) in file URLs. This reflected the original URL syntax, which made the colon a reserved character in a path part.

For network shares, add an additional two slashes. For example, \\remotehost\share\dir\file.txt, becomes file:////remotehost/share/dir/file.txt.

Usually interpreters manage to access both file://localhost///remotehost/share/dir/file.txt, and file:////remotehost/share/dir/file.txt

[edit] Web pages

file: URIs are rarely used in Web pages on the Internet, since they make the assumption that such a file exists on the client's computer. The host specifier can be used to retrieve a file from an external source, although no specific file-retrieval protocol is specified; and using it should result in a message that informs the user that no mechanism to access that machine is available.

[edit] Mozilla

Mozilla browsers refuse to follow file: links on a page that it has fetched with the HTTP protocol, so that the page's own URL is an http: URL. When you click on such a link, nothing happens. The purpose is security: to prevent a remote page from executing a program on the visitor's computer. The file: links work on Mozilla on pages that are local files on the user's disk. It is not a surprise that Firefox 3.5.3 does nothing when requesting

 file:////remotehost/share/dir/file.txt  

(because it is a file on a remote host), however it succeeds to open

 file://localhost///remotehost/share/dir/file.txt 

or its equivalent

 file://///remotehost/share/dir/file.txt  

as it is referred to as a file on the local host.

Mozilla browsers can be configured to override this security restriction as detailed in Mozillazine's "Links to Local Pages Don't Work".

Mozilla browsers also treat file: URLs similarly to the Gopher protocol in the way a directory is represented textually (i.e. the source) and graphically.

[edit] Internet Explorer

Internet Explorer browsers, prior to version 7, will attempt to access file: URLs even if they reside on pages fetched over HTTP.

[edit] Other

The original Web browser, WorldWideWeb, provided editing of resources in file: space [1]. Amaya still has this ability.

[edit] External links

• File URLs

v • d • e URI scheme Official aaa · aaas · acap · cap · cid · crid · data · dav · dict · dns · fax · file · ftp · go · gopher · h323 · http · https · im · imap · Info · ldap · mailto · mid · news · nfs · nntp · pop · pres · rtsp · sip · sips · snmp · tag · tel · telnet · urn · wais · xmpp Unofficial about · afp · aim · apt · bolo · bzr · callto · cel · cvs · daap · ed2k · feed · fish · gg · git · gizmoproject · iax2 · irc · ircs · itms · lastfm · ldaps · magnet · mms · msnim · psyc · rsync · secondlife · skype · ssh · svn · sftp · smb · sms · soldat · steam · unreal · ut2004 · view-source · vzochat · webcal · wyciwyg · xfire · ymsgr Protocol List