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.