rename(3Tcl)							  rename(3Tcl)

NAME    [Toc]    [Back]

     rename - Rename or	delete a command

SYNOPSIS    [Toc]    [Back]

     rename oldName newName

DESCRIPTION    [Toc]    [Back]

     Rename the	command	that used to be	called oldName so that it is now
     called newName.  If newName is an empty string then oldName is deleted.
     The rename	command	returns	an empty string	as result.

KEYWORDS    [Toc]    [Back]

     command, delete, rename
RENAME(3F)							    RENAME(3F)

NAME    [Toc]    [Back]

     rename - rename a file

SYNOPSIS    [Toc]    [Back]

     integer function rename (from, to)
     character*(*) from, to

DESCRIPTION    [Toc]    [Back]

     From must be the pathname of an existing file.  To	will become the	new
     pathname for the file.  If	to exists, then	both from and to must be the
     same type of file,	and must reside	on the same filesystem.	 If to exists,
     it	will be	removed	first.

     The returned value	will be	0 if successful; a system error	code
     otherwise.

FILES    [Toc]    [Back]

     /usr/lib/libU77.a

SEE ALSO    [Toc]    [Back]

     rename(2),	perror(3F)

BUGS    [Toc]    [Back]

     Pathnames can be no longer	than MAXPATHLEN	as defined in <sys/param.h>.


									PPPPaaaaggggeeee 1111