usam_mig_stage_file_req(3)

NAME
     usam_mig_stage_file_req - Stages request  from  the  foreign
     data migration program

SYNOPSIS
     cc [ flag  ... ] file  ...  -L/opt/SUNWsamfs/lib  -lsamut  [library ... ]

     #include "/opt/SUNWsamfs/include/mig.h"

     int usam_mig_stage_file_req();

AVAILABILITY
     SUNWsamfs

DESCRIPTION
     usam_mig_stage_file_req() is the stage request  routine  for
     the  SAM-QFS  Migration Toolkit.  The foreign data migration
     program adds this stage request to  an  internally-generated
     worklist being maintained by third party API.  This worklist
     should   be   processed   by    a    thread    started    by
     usam_mig_initialize().  This worklist is processed by a pro-
     gram started with usam_mig_initialize().  The  thread  finds
     and positions the media to stage the file through stage_api.

RETURN VALUES
     A successful stage request returns a value of 0.  Otherwise,
     a  value  of  1  is returned and errno is passed to the file
     system.

ERRORS
     usam_mig_stage_file_req() fails if the following is true:

     EEXIST              This is a duplicate stage request for  a
                         file.

FILES
     /opt/SUNWsamfs/migkit/mig_cd.c
                         The example Migration Toolkit program.

     /etc/opt/SUNWsamfs/mcf
                         The configuration file for Sun  QFS  and
                         SAM-QFS file systems.

SEE ALSO
     sam_migd(3).

     mcf(4).