Procedure

     DAFLUH ( DAF, logical unit to handle )

     ENTRY DAFLUH ( UNIT, HANDLE )

Abstract

     Return the handle associated with a logical unit.

Required_Reading

     DAF

Keywords

     CONVERSION
     DAF
     FILES

Declarations

    INTEGER               UNIT
    INTEGER               HANDLE

Brief_I/O

     VARIABLE  I/O  DESCRIPTION
     --------  ---  --------------------------------------------------
     UNIT       I   Logical unit connected to a DAF.
     HANDLE     O   Corresponding DAF file handle.

Detailed_Input

     UNIT     is the logical unit to which a DAF has been
              connected after it has been opened.

Detailed_Output

     HANDLE   is the handle associated with the file.

Parameters

     None.

Exceptions

     1)  If the specified unit is not connected to any file that is
         currently loaded as a DAF, the error SPICE(DAFNOSUCHUNIT)
         is signaled. The value of HANDLE returned is undefined in
         this case.

Files

     None.

Particulars

     It is unlikely, but possible, that a calling program would know
     the logical unit to which a file is connected without knowing the
     handle associated with the file. DAFLUH is provided mostly for
     completeness.

Examples

     In the following code fragment, the handle associated with
     a DAF is retrieved using the logical unit to which the
     file is connected. The handle is then used to determine the
     name of the file.

        CALL DAFLUH ( UNIT,   HANDLE )
        CALL DAFHFN ( HANDLE, FNAME )

Restrictions

     1)  This routine may only be used to retrieve handles for logical
         units connected to DAFs loaded or created using the interfaces
         available in this entry point umbrella. Using this entry point
         to retrieve handles for files not loaded through these
         interfaces may result in unexpected behavior.

Literature_References

     None.

Author_and_Institution

     N.J. Bachman       (JPL)
     J. Diaz del Rio    (ODC Space)
     K.R. Gehringer     (JPL)
     H.A. Neilan        (JPL)
     W.L. Taber         (JPL)
     F.S. Turner        (JPL)
     I.M. Underwood     (JPL)
     E.D. Wright        (JPL)

Version

    SPICELIB Version 8.0.2, 25-NOV-2021 (JDR)

        Edited the header to comply with NAIF standard.

    SPICELIB Version 8.0.1, 10-OCT-2012 (EDW)

        Corrected ordering of header section.

        Removed the obsolete Reference citation to "NAIF
        Document 167.0."

    SPICELIB Version 8.0.0, 13-NOV-2001 (FST)

        This routine was updated to utilize the new handle manager
        software to manage binary file formats and consolidated
        I/O code.

    SPICELIB Version 7.0.4, 08-OCT-1999 (WLT)

        The environment lines were expanded so that the supported
        environments are now explicitly given. New
        environments are WIN-NT

    SPICELIB Version 7.0.3, 16-SEP-1999 (NJB)

        CSPICE environments were added. Some typos were corrected.

    SPICELIB Version 7.0.2, 28-JUL-1999 (WLT)

        The environment lines were expanded so that the supported
        environments are now explicitly given. New
        environments are PC-DIGITAL, SGI-O32 and SGI-N32.

    SPICELIB Version 7.0.1, 17-MAR-1999 (WLT)

        The environment lines were expanded so that the supported
        environments are now explicitly given. Previously,
        environments such as SUN-SUNOS and SUN-SOLARIS were implied
        by the environment label SUN.

    SPICELIB Version 1.0.3, 29-SEP-1993 (KRG)

        Removed references to specific DAF file open routines in the
        $Detailed_Input section of the header. This was done in order
        to minimize documentation changes if these open routines ever
        change.

    SPICELIB Version 1.0.2, 10-MAR-1992 (WLT)

        Comment section for permuted index source lines was added
        following the header.

    SPICELIB Version 1.0.1, 22-MAR-1990 (HAN)

        Literature references added to the header.

    SPICELIB Version 1.0.0, 31-JAN-1990 (IMU)