JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual     Sun QFS and Sun Storage Archive Manager 5.3 Information Library
search filter icon
search icon

Document Information

Preface

1.  User Commands (Man Pages Section 1)

2.  Maintenance Commands (Man Pages Section 1M)

3.  Library Functions (Man Pages Section 3)

intro_libsam(3)

intro_libsamrpc(3)

qfs_listio(3)

sam_advise(3)

sam_archive(3)

sam_audit(3)

sam_cancelstage(3)

sam_chmed(3)

sam_clear_request(3)

sam_closecat(3)

sam_damage(3)

sam_devstat(3)

sam_devstr(3)

sam_errno(3)

sam_exarchive(3)

sam_export(3)

sam_getcatalog(3)

sam_getfsdata(3)

sam_getfsdisks(3)

sam_import(3)

sam_load(3)

sam_lstat(3)

sam_mig_create_file(3)

sam_mig_mount_media(3)

sam_mig_rearchive(3)

sam_mig_release_device(3)

sam_mig_stage_end(3)

sam_mig_stage_error(3)

sam_mig_stage_file(3)

sam_mig_stage_write(3)

sam_move(3)

sam_odlabel(3)

sam_opencat(3)

sam_readrminfo(3)

sam_rearch(3)

sam_release(3)

sam_request(3)

sam_restore_copy(3)

sam_restore_file(3)

sam_segment(3)

sam_segment_stat(3)

sam_segment_vsn_stat(3)

sam_set_fs_contig(3)

sam_set_fs_thresh(3)

sam_set_state(3)

sam_setfa(3)

sam_settings(3)

sam_ssum(3)

sam_stage(3)

sam_stat(3)

sam_tplabel(3)

sam_unarchive(3)

sam_undamage(3)

sam_unload(3)

sam_unrearch(3)

sam_vsn_stat(3)

usam_mig_cancel_stage_req(3)

usam_mig_initialize(3)

usam_mig_stage_file_req(3)

4.  Library Functions (Man Pages Section 3X)

5.  File Formats (Man Pages Section 4)

6.  Standards, Environment, and Macros (Man Pages Section 5)

7.  Device and Network Interfaces (Man Pages Section 7)

sam_clear_request(3)

NAME
     sam_clear_request - Clears entry from removable media  mount
     requests

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

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

     int sam_clear_request(uint_t slot, int wait_response);

DESCRIPTION
     sam_clear_request() clears removable media entry from  mount
     request  list.  The call will return immediately after issu-
     ing the command  if  zero  is  specified  for  wait_response
     value.   Other  values for wait_response will give undefined
     results.

RETURN VALUES
     Upon succesful completion a value of 0 is returned.   Other-
     wise, a value of -1 is returned and errno is set to indicate
     the error.

ERRORS
     sam_clear_request() fails if one or more  of  the  following
     are true:

     ER_FIFO_PATH_LENGTH The path and filename for the FIFO  pipe
                         is too long.

     ER_NO_MASTER_SHM    No Sun  QFS  or  SAM-QFS  master  shared
                         memory  segment defined.  Check that the
                         Sun QFS  or  SAM-QFS  file  systems  are
                         mounted.

     ER_NO_MASTER_SHM_ATT
                         No Sun  QFS  or  SAM-QFS  master  shared
                         memory  segment  found.   Check that the
                         Sun QFS  or  SAM-QFS  file  systems  are
                         mounted.

     ER_NO_RESPONSE_FIFO Unable to create the response FIFO pipe.

     ER_OPERATOR_NOT_PRIV
                         Operator does  not  have  permission  to
                         perform a full audit

SEE ALSO
     samu(1M).