dosdup

Purpose

     Duplicates a DOS Services file handle.

Library

     DOS Services Library (libdos.a)

Syntax

     #include <dos.h>

     int dosdup (dosfile)
     DOSFILE dosfile;

Description

     The dosdup subroutine returns  a new file descriptor that
     indicates the  same file and  has the same open  flags as
     the original file descriptor.  The dosfile parameter is a
     file  descriptor  returned   by  dosread,  doscreate,  or
     dosdup.  The file  position is initially set  to the same
     value as  the original,  but changes  independently.  The
     file descriptor returned is the lowest one available.

Return Value

     Upon successful completion, a DOS Services file handle is
     returned.  If the dosdup subroutine  fails, a value of -1
     is returned and doserrno is set to indicate the error.

Related Information

     In  this  book:    "DOS  services  library,"  "dosclose."
     "doscreate," and  "dosopen."