Signature:

      SUBROUTINE h5olink_f(object_id, new_loc_id, new_link_name,  &
                hdferr, lcpl_id, lapl_id)
        IMPLICIT NONE
        INTEGER(HID_T)  , INTENT(IN)  :: object_id
        INTEGER(HID_T)  , INTENT(IN)  :: new_loc_id
        CHARACTER(LEN=*), INTENT(IN)  :: new_link_name
        INTEGER         , INTENT(OUT) :: hdferr
        INTEGER(HID_T)  , INTENT(IN), OPTIONAL :: lcpl_id
        INTEGER(HID_T)  , INTENT(IN), OPTIONAL :: lapl_id

Inputs:

      object_id     - Object to be linked.
      new_loc_id    - File or group identifier specifying location at
                      which object is to be linked.
      new_link_name - Name of link to be created, relative to new_loc_id.

Outputs:

      hdferr        - Returns 0 if successful and -1 if fails.

Optional parameters:

      lcpl_id       - Link creation property list identifier.
      lapl_id       - Link access property list identifier.