1explain_symlink_or_die(3) Library Functions Manual explain_symlink_or_die(3)
2
3
4
6 explain_symlink_or_die - make a new name for a file and report errors
7
9 #include <libexplain/symlink.h>
10 void explain_symlink_or_die(const char *oldpath, const char *newpath);
11
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
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 1.4
43 Copyright (C) 2008 Peter Miller
44
45
46
47 explain_symlink_or_die(3)