1explain_symlink_or_die(3)  Library Functions Manual  explain_symlink_or_die(3)
2
3
4

NAME

6       explain_symlink_or_die - make a new name for a file and report errors
7

SYNOPSIS

9       #include <libexplain/symlink.h>
10       void explain_symlink_or_die(const char *oldpath, const char *newpath);
11

DESCRIPTION

13       The explain_symlink_or_die function is used to call the symlink(2) sys‐
14       tem call.  On  failure  an  explanation  will  be  printed  to  stderr,
15       obtained  from  explain_symlink(3),  and then the process terminates by
16       calling exit(EXIT_FAILURE).
17
18       This function is intended to be used in a fashion similar to  the  fol‐
19       lowing example:
20              explain_symlink_or_die(oldpath, newpath);
21
22       oldpath The  oldpath,  exactly as to be passed to the symlink(2) system
23               call.
24
25       newpath The newpath, exactly as to be passed to the  symlink(2)  system
26               call.
27
28       Returns:
29               This  function  only returns on success.  On failure, prints an
30               explanation and exits.
31

SEE ALSO

33       symlink(2)
34               make a new name for a file
35
36       explain_symlink(3)
37               explain symlink(2) errors
38
39       exit(2) terminate the calling process
40
42       libexplain version 0.40
43       Copyright (C) 2008 Peter Miller
44
45
46
47                                                     explain_symlink_or_die(3)
Impressum