Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/lib_ref/i/iofunc_rename.html on line 1
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/lib_ref/i/iofunc_rename.html on line 1
Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/lib_ref/i/iofunc_rename.html on line 8
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/lib_ref/i/iofunc_rename.html on line 8
Do permission checks for a _IO_CONNECT_RENAME message
#include <sys/iofunc.h>
int iofunc_rename( resmgr_context_t* ctp,
io_rename_t* msg,
iofunc_attr_t* oldattr,
iofunc_attr_t* olddattr,
iofunc_attr_t* newattr,
iofunc_attr_t* newdattr,
struct _client_info* info );
- ctp
- A pointer to a
resmgr_context_t
structure that the resource-manager library uses to pass context information
between functions.
- msg
- A pointer to the
io_rename_t
structure that contains the message that the resource manager received;
see below.
- oldattr
- A pointer to the
iofunc_attr_t
structure that describes the characteristics of the resource.
- olddattr
- NULL, or a pointer to the iofunc_attr_t
structure that describes the characteristics of the parent directory.
- newattr
- A pointer to the
iofunc_attr_t
structure that describes the characteristics of the target, if it exists.
- newdattr
- NULL, or a pointer to the iofunc_attr_t
structure that describes the characteristics of the parent directory
of the target.
- info
- NULL, or a pointer to a _client_info
structure that contains the information about a client connection.
For information about this structure, see
ConnectClientInfo().
libc
Use the -l c option to
qcc
to link against this library.
This library is usually included automatically.
The function iofunc_rename() does
permission checks for the _IO_CONNECT message
(subtype _IO_CONNECT_RENAME)
for context ctp.
The newattr argument is the attribute of the target
if it already exists.
This function is similar to
iofunc_open().
The iofunc_rename() function checks to see if the client
(described by the optional info structure) has access to
open the resource (name passed in the msg structure).
The attr structure describes the resource's attributes.
The info argument can be passed as NULL,
in which case iofunc_rename() obtains the client
information itself via a call to
iofunc_client_info().
It is, of course, more efficient to get the client information once,
rather than call this function with NULL
every time.
The io_rename_t structure holds the _IO_CONNECT
message received by the resource manager:
typedef union {
struct _io_connect connect;
struct _io_connect_link_reply link_reply;
struct _io_connect_ftype_reply ftype_reply;
} io_rename_t;
This message structure is a union of an input message (coming to the
resource manager),
_io_connect,
and two possible output or reply messages (going back to the client):
The reply includes the following extra information:
typedef union _io_rename_extra {
char path[1];
} io_rename_extra_t;
- EACCES
- The client doesn't have permissions to do the operation.
- EBADFSYS
- NULL was passed in oldattr, olddattr, or newdattr.
- EFAULT
- A fault occurred when the kernel tried to access the info buffer.
- EINVAL
- The oldattr and newdattr have identical values, the client process is no longer valid,
or attempt to remove the parent (".") directory.
- EISDIR
- The old link is a directory but the new link isn't a directory.
- ENOTDIR
- Attempt to unlink a nondirectory entry using directory semantics (e.g. rmdir file).
- ENOTEMPTY
- Attempt to remove a directory that isn't empty.
- EOK
- Successful completion or there was already a newattr entry.
- EPERM
- The group ID or owner ID didn't match.
- EROFS
- Attempt to remove an entry on a read-only filesystem.
QNX Neutrino
Safety: | |
Cancellation point |
No |
Interrupt handler |
No |
Signal handler |
Yes |
Thread |
Yes |
_io_connect,
_io_connect_link_reply,
_io_connect_ftype_reply,
iofunc_client_info(),
iofunc_open()
Writing a Resource Manager
Resource Managers
chapter of Getting Started with QNX Neutrino
Warning: main(/www/www/htdocs/style/footer.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/lib_ref/i/iofunc_rename.html on line 268
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/footer.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/lib_ref/i/iofunc_rename.html on line 268