<?xml version="1.0" encoding="utf-8" ?> <!-- for emacs: -*- coding: utf-8 -*- -->
<!-- Apache may like this line in the file .htaccess: AddCharset utf-8 .html -->
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1 plus MathML 2.0 plus SVG 1.1//EN" "http://www.w3.org/2002/04/xhtml-math-svg/xhtml-math-svg-flat.dtd" >
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head><title>realpath -- convert a filename to one passing through no symbolic links</title>
<link rel="stylesheet" type="text/css" href="../../../../Macaulay2/Style/doc.css"/>
</head>
<body>
<table class="buttons">
<tr>
<td><div><a href="_temporary__File__Name.html">next</a> | <a href="_read__Directory.html">previous</a> | <a href="_temporary__File__Name.html">forward</a> | <a href="_read__Directory.html">backward</a> | <a href="_file_spmanipulation.html">up</a> | <a href="index.html">top</a> | <a href="master.html">index</a> | <a href="toc.html">toc</a> | <a href="http://www.math.uiuc.edu/Macaulay2/">Macaulay2 web site</a></div>
</td>
</tr>
</table>
<div><a href="index.html" title="">Macaulay2Doc</a> > <a href="___The_sp__Macaulay2_splanguage.html" title="">The Macaulay2 language</a> > <a href="_file_spmanipulation.html" title="Unix file manipulation functions">file manipulation</a> > <a href="_realpath.html" title="convert a filename to one passing through no symbolic links">realpath</a></div>
<hr/>
<div><h1>realpath -- convert a filename to one passing through no symbolic links</h1>
<div class="single"><h2>Synopsis</h2>
<ul><li><div class="list"><dl class="element"><dt class="heading">Usage: </dt><dd class="value"><div><tt>realpath fn</tt></div>
</dd></dl>
</div>
</li>
<li><div class="single">Inputs:<ul><li><span><tt>fn</tt>, <span>a <a href="___String.html">string</a></span>, a filename, or path to a file</span></li>
</ul>
</div>
</li>
<li><div class="single">Outputs:<ul><li><span><span>a <a href="___String.html">string</a></span>, a pathname to <tt>fn</tt> passing through no symbolic links, and ending with a slash if <tt>fn</tt> refers to a directory</span></li>
</ul>
</div>
</li>
</ul>
</div>
<div class="single"><h2>Description</h2>
<div><table class="examples"><tr><td><pre>i1 : realpath "."
o1 = /tmp/M2-25461-982-rundir/</pre>
</td></tr>
<tr><td><pre>i2 : p = temporaryFileName()
o2 = /tmp/M2-11020-1</pre>
</td></tr>
<tr><td><pre>i3 : q = temporaryFileName()
o3 = /tmp/M2-11020-2</pre>
</td></tr>
<tr><td><pre>i4 : symlinkFile(p,q)</pre>
</td></tr>
<tr><td><pre>i5 : p << close
o5 = /tmp/M2-11020-1
o5 : File</pre>
</td></tr>
<tr><td><pre>i6 : readlink q
o6 = /tmp/M2-11020-1</pre>
</td></tr>
<tr><td><pre>i7 : realpath q
o7 = /tmp/M2-11020-1</pre>
</td></tr>
<tr><td><pre>i8 : removeFile p</pre>
</td></tr>
<tr><td><pre>i9 : removeFile q</pre>
</td></tr>
</table>
<p>The empty string is interpreted as a reference to the current directory.</p>
<table class="examples"><tr><td><pre>i10 : realpath ""
o10 = /tmp/M2-25461-982-rundir/</pre>
</td></tr>
</table>
</div>
</div>
<div class="single"><h2>Caveat</h2>
<div>Every component of the path must exist in the file system and be accessible to the user. Terminal slashes will be dropped. Warning: under most operating systems, the value returned is an absolute path (one starting at the root of the file system), but under Solaris, this system call may, in certain circumstances, return a relative path when given a relative path.</div>
</div>
<div class="single"><h2>See also</h2>
<ul><li><span><a href="_readlink.html" title="readlink fn">readlink</a> -- readlink fn</span></li>
</ul>
</div>
</div>
</body>
</html>
