pathmgr_symlink()
Create a symlink
Synopsis:
#include <sys/pathmgr.h> int pathmgr_symlink( const char * path, const char * symlink );
Arguments:
- path
- The path that you want to link to.
- symlink
- The name of the link that you want to create.
Library:
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
Description:
The pathmgr_symlink() function creates a symbolic link, path, in the process manager that redirects to the path specified by symlink.
In order to create the link, your process must have the PROCMGR_AID_PATHSPACE ability enabled. For more information, see procmgr_ability() .
The pathmgr_unlink() function removes the link.
The symbolic link isn't permanent and is lost when the system reboots.
Returns:
- 0
- Success.
- -1
- An error occurred (errno is set).
Examples:
#include <stdio.h> #include <sys/pathmgr.h> int main(int argc, char **argv) { /* Create a link from /mytmp to /dev/shmem */ if(pathmgr_symlink("/dev/shmem", "/mytmp") == -1) { perror("Can't make link"); } getchar(); if(pathmgr_unlink("/mytmp") == -1) { perror("Can't unlink "); } return 0; }
Classification:
Safety: | |
---|---|
Cancellation point | Yes |
Interrupt handler | No |
Signal handler | Yes |
Thread | Yes |