explain_symlink_or_die(3)                            explain_symlink_or_die(3)



NNAAMMEE
       explain_symlink_or_die - make a new name for a file and report errors

SSYYNNOOPPSSIISS
       #include <libexplain/symlink.h>
       void explain_symlink_or_die(const char *oldpath, const char *newpath);

DDEESSCCRRIIPPTTIIOONN
       The eexxppllaaiinn__ssyymmlliinnkk__oorr__ddiiee function is used to call the _s_y_m_l_i_n_k(2) sys-
       tem call.  On  failure  an  explanation  will  be  printed  to  _s_t_d_e_r_r,
       obtained  from  _e_x_p_l_a_i_n___s_y_m_l_i_n_k(3),  and then the process terminates by
       calling exit(EXIT_FAILURE).

       This function is intended to be used in a fashion similar to  the  fol-
       lowing example:
              explain_symlink_or_die(oldpath, newpath);

       _o_l_d_p_a_t_h The  oldpath,  exactly as to be passed to the _s_y_m_l_i_n_k(2) system
               call.

       _n_e_w_p_a_t_h The newpath, exactly as to be passed to the  _s_y_m_l_i_n_k(2)  system
               call.

       Returns:
               This  function  only returns on success.  On failure, prints an
               explanation and exits.

SSEEEE AALLSSOO
       _s_y_m_l_i_n_k(2)
               make a new name for a file

       _e_x_p_l_a_i_n___s_y_m_l_i_n_k(3)
               explain _s_y_m_l_i_n_k(2) errors

       _e_x_i_t(2) terminate the calling process

CCOOPPYYRRIIGGHHTT
       libexplain version 1.4
       Copyright (C) 2008 Peter Miller



                                                     explain_symlink_or_die(3)
