#!/usr/local/bin/scripts/sh
#
#.Y / 70 83 / / / / 105 / / / /  / /               ;A4_QUER.Y
#.YT 3 2 0 0 3 3 1 / / /
#.H!a!0:linux/<scripts>/io/disk/mediaAccess/mediaHandlers.d/00000000_0000_0000_0000_000000000000!0.!c
#
#/*******************************************************************************
#     io disk mediaAccess mediaHandlers.d/00000000_0000_0000_0000_000000000000
#     ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
#
#     purpose             : media handler for a 'deleted' media; does actually
#                           nothing but confirm the deleting-date.
#
#     begin               : Mon Jul 16 16:35:04 CEST 2018
#
#     changes             :
#
#     copyright           : (C) 2018 by Thomas Bruecker
#
#     email               : public@thomas-r-bruecker.ch
#
#     version             : -0.0.0
#
#*******************************************************************************/

#/***************************************************************************
# *                                                                         *
# *   This program is free software; you can redistribute it and/or modify  *
# *   it under the terms of the GNU General Public License as published by  *
# *   the Free Software Foundation; either version 2 of the License, or     *
# *   (at your option) any later version.                                   *
# *                                                                         *
# *   This program is distributed in the hope that it will be useful, but   *
# *   WITHOUT ANY WARRANTY; without even the implied warranty of            *
# *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU      *
# *   General Public License for more details.                              *
# *                                                                         *
# *   You should have received a copy of the GNU General Public License     *
# *   along with this program; if not, write to the Free Software           *
# *   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,            *
# *   MA 02110-1301 USA.                                                    *
# *                                                                         *
# ***************************************************************************/

# MyHash("00000000_0000_0000_0000_000000000000") = 0x077C
#
# * for every function:
#   * if returned result is not commented, the function returns 0 on no-error.


disk_mediaAccess_00000000_0000_0000_0000_000000000000() {
  # handles a 'deleted' media; does actually nothing but confirm the deleting-date;
  # $1: ^command, in '*'.

  local      COMMAND INDEX MediaInfo ParentMedia

  COMMAND="$1"
  INDEX="$2"
  MediaInfo="$3"
  ParentMedia="$4"

  # echo  $COMMAND                                                >>/dev/stderr
  # echo  $INDEX                                                  >>/dev/stderr
  # echo  "$MediaInfo"                                            >>/dev/stderr
  # echo  $ParentMedia                                            >>/dev/stderr

  # quick, for verifying and 'wait':
    disk_mediaAccess__VerifyNoWait  "$COMMAND"  && return 0
                                                   # if ok, return 0; no
                                                   # waiting for component
                                                   # medias at all.

  case "$COMMAND" in
      2ChildDev|2ChildMedia|CHECK|DESTROY|REALIZE|RealizeForced|REPAIR)
        disk_mediaAccess___0x077C_00_INFO  "$MediaInfo"  ;;
      SIZE)
        disk_mediaAccess__Size1                          ;;
      *)
        disk_mediaAccess___NoContainer                   \
          "$COMMAND" "$INDEX" "$ParentMedia"             \
          || return                                # return on error.

        disk_mediaAccess__InvalidCommandError            \
          "$COMMAND" "$INDEX"                            \
          '00000000_0000_0000_0000_000000000000'         \
          "$ParentMedia"                                 ;;
    esac                                           # return result of previous
}                                                  # command.


disk_mediaAccess___0x077C_00_INFO() {
  # confirms the deleting-date; writes it to "stdout";
  # $1: <MediaInfo>.

  local  MediaInfo

  MediaInfo="$1"
  # echo  "$MediaInfo"                                            >>/dev/stderr

  ParametersFile="$(disk_mediaAccess__Parameters2File  "$MediaInfo")"  \
    || return                                      # return on error.
    .  "$ParametersFile"  || return                # return on error.

  # echo  $COPYRIGHT                                              >>/dev/stderr
  # echo  $CopyrightDetails                                       >>/dev/stderr
  # echo  $DATE                                                   >>/dev/stderr
  # echo  $OPERATOR                                               >>/dev/stderr
  # echo  $URL                                                    >>/dev/stderr

   echo  -e  "\n\nDeleted by \"$OPERATOR\"; at ${DATE}.\n\n"      >>/dev/stderr
}