[ новости /+++ | форум | теги | ]

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
                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
     tt_c(5), tt_file_copy(3), tt_file_destroy(3), rename(2).

Партнёры:

Хостинг: