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

NAME

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

SYNOPSIS

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

DESCRIPTION

13       The  explain_link_or_die  function  is  used to call the link(2) system
14       call.  On failure an explanation will be printed  to  stderr,  obtained
15       from  explain_link(3),  and  then  the  process  terminates  by calling
16       exit(EXIT_FAILURE).
17
18       This function is intended to be used in a fashion similar to  the  fol‐
19       lowing example:
20              explain_link_or_die(oldpath, newpath);
21
22       oldpath The  oldpath,  exactly  as  to  be passed to the link(2) system
23               call.
24
25       newpath The newpath, exactly as to be  passed  to  the  link(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       link(2) make a new name for a file
34
35       explain_link(3)
36               explain link(2) errors
37
38       exit(2) terminate the calling process
39

41       libexplain version 1.4
42       Copyright (C) 2008 Peter Miller
43
44
45
46                                                        explain_link_or_die(3)
Impressum