tt_file_move(3)

tt_file_move(3)	       C LIBRARY FUNCTIONS	  tt_file_move(3)

NAME
     tt_file_move - move objects from one file to another

SYNOPSIS
     #include <Tt/tt_c.h>

     Tt_status tt_file_move(const char *oldfilepath,
			    const char *newfilepath);

DESCRIPTION
     The tt_file_move()	function destroys all objects that  exist
     on	 the  files  and  directories rooted at	newfilepath, then
     moves all objects that exist on oldfilepath to newfilepath.

     If	oldfilepath and	newfilepath reside in the same file  sys-
     tem, tt_file_move() replaces oldfilepath with newfilepath in
     the path associated with every object in that  file  system;
     that  is,	all  the  objects in the directory tree	rooted at
     oldfilepath are overlaid onto newfilepath.	  In  this  mode,
     the behavior of tt_file_move() is similar to rename(2).

     If	oldfilepath and	newfilepath reside in different	file sys-
     tems, neither can be a directory.

     The oldfilepath argument is the name of the file  or  direc-
     tory  whose  objects are to be moved.  The	newfilepath argu-
     ment is the name of the  file  or	directory  to  which  the
     objects are to be moved.

RETURN VALUE
     Upon  successful  completion,  the	 tt_file_move()	 function
     returns  the status of the	operation as one of the	following
     Tt_status values:

	TT_OK	The operation completed	successfully.

	TT_ERR_ACCESS
		The user does not have the  necessary  access  to
		the object and/or the process.

	TT_ERR_DBAVAIL
		The ToolTalk service could not access  the  Tool-
		Talk database needed for this operation.

	TT_ERR_DBEXIST
		The ToolTalk service could not access the  speci-
		fied ToolTalk database in the expected place.

	TT_ERR_FILE
		The specified file does	not exist or it	is  inac-
		cessible.

	TT_ERR_NOMP

Unix System LaboratorLast change: 11 May 1994			1

tt_file_move(3)	       C LIBRARY FUNCTIONS	  tt_file_move(3)

		The ttsession(1) process is not	running	 and  the
		ToolTalk service cannot	restart	it.

	TT_ERR_PATH
		The specified pathname included	 an  unsearchable
		directory,  or oldfilepath and newfilepath reside
		in different file systems, and either is a direc-
		tory.

	TT_ERR_POINTER
		The pointer passed does	not point to an	object of
		the correct type for this operation.

SEE ALSO
     Tttt_c(5),	tt_file_copy(3), tt_file_destroy(3); rename(2)

Unix System LaboratorLast change: 11 May 1994			2