1<html lang="en"> 2<head> 3<title>rename - Debugging with GDB</title> 4<meta http-equiv="Content-Type" content="text/html"> 5<meta name="description" content="Debugging with GDB"> 6<meta name="generator" content="makeinfo 4.13"> 7<link title="Top" rel="start" href="index.html#Top"> 8<link rel="up" href="List-of-Supported-Calls.html#List-of-Supported-Calls" title="List of Supported Calls"> 9<link rel="prev" href="lseek.html#lseek" title="lseek"> 10<link rel="next" href="unlink.html#unlink" title="unlink"> 11<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> 12<!-- 13Copyright (C) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 141998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 15Free Software Foundation, Inc. 16 17Permission is granted to copy, distribute and/or modify this document 18under the terms of the GNU Free Documentation License, Version 1.3 or 19any later version published by the Free Software Foundation; with the 20Invariant Sections being ``Free Software'' and ``Free Software Needs 21Free Documentation'', with the Front-Cover Texts being ``A GNU Manual,'' 22and with the Back-Cover Texts as in (a) below. 23 24(a) The FSF's Back-Cover Text is: ``You are free to copy and modify 25this GNU Manual. Buying copies from GNU Press supports the FSF in 26developing GNU and promoting software freedom.''--> 27<meta http-equiv="Content-Style-Type" content="text/css"> 28<style type="text/css"><!-- 29 pre.display { font-family:inherit } 30 pre.format { font-family:inherit } 31 pre.smalldisplay { font-family:inherit; font-size:smaller } 32 pre.smallformat { font-family:inherit; font-size:smaller } 33 pre.smallexample { font-size:smaller } 34 pre.smalllisp { font-size:smaller } 35 span.sc { font-variant:small-caps } 36 span.roman { font-family:serif; font-weight:normal; } 37 span.sansserif { font-family:sans-serif; font-weight:normal; } 38--></style> 39<link rel="stylesheet" type="text/css" href="../cs.css"> 40</head> 41<body> 42<div class="node"> 43<a name="rename"></a> 44<p> 45Next: <a rel="next" accesskey="n" href="unlink.html#unlink">unlink</a>, 46Previous: <a rel="previous" accesskey="p" href="lseek.html#lseek">lseek</a>, 47Up: <a rel="up" accesskey="u" href="List-of-Supported-Calls.html#List-of-Supported-Calls">List of Supported Calls</a> 48<hr> 49</div> 50 51<h5 class="unnumberedsubsubsec">rename</h5> 52 53<p><a name="index-rename_002c-file_002di_002fo-system-call-2509"></a> 54 <dl> 55<dt>Synopsis:<dd> 56 <pre class="smallexample"> int rename(const char *oldpath, const char *newpath); 57</pre> 58 <br><dt>Request:<dd>‘<samp><span class="samp">Frename,</span><var>oldpathptr</var><span class="samp">/</span><var>len</var><span class="samp">,</span><var>newpathptr</var><span class="samp">/</span><var>len</var></samp>’ 59 60 <br><dt>Return value:<dd>On success, zero is returned. On error, -1 is returned. 61 62 <br><dt>Errors:<dd> 63 <dl> 64<dt><code>EISDIR</code><dd><var>newpath</var> is an existing directory, but <var>oldpath</var> is not a 65directory. 66 67 <br><dt><code>EEXIST</code><dd><var>newpath</var> is a non-empty directory. 68 69 <br><dt><code>EBUSY</code><dd><var>oldpath</var> or <var>newpath</var> is a directory that is in use by some 70process. 71 72 <br><dt><code>EINVAL</code><dd>An attempt was made to make a directory a subdirectory 73of itself. 74 75 <br><dt><code>ENOTDIR</code><dd>A component used as a directory in <var>oldpath</var> or new 76path is not a directory. Or <var>oldpath</var> is a directory 77and <var>newpath</var> exists but is not a directory. 78 79 <br><dt><code>EFAULT</code><dd><var>oldpathptr</var> or <var>newpathptr</var> are invalid pointer values. 80 81 <br><dt><code>EACCES</code><dd>No access to the file or the path of the file. 82 83 <br><dt><code>ENAMETOOLONG</code><dd> 84<var>oldpath</var> or <var>newpath</var> was too long. 85 86 <br><dt><code>ENOENT</code><dd>A directory component in <var>oldpath</var> or <var>newpath</var> does not exist. 87 88 <br><dt><code>EROFS</code><dd>The file is on a read-only filesystem. 89 90 <br><dt><code>ENOSPC</code><dd>The device containing the file has no room for the new 91directory entry. 92 93 <br><dt><code>EINTR</code><dd>The call was interrupted by the user. 94</dl> 95 96 </dl> 97 98 </body></html> 99 100