Click above to get retro games delivered to your door ever month!

  Sx_KillSem():

  Syntax:   Sx_KillSem([nOrder | cName])

            nOrder = Position of index in list of indexes
            cName  = Name for the semaphore file

  Returns:   <numeric> Number of users remaining for this semaphore
                    file;  -1 if an error occurred.

  Description:    This function is used to remove a user instance from
                  semaphore file using the name of an active index or a
                  specified name.

                  If an index order is specified, then the name of that
                  index is used for the file.  The current index name (if
                  any) is used if no argument is supplied.  The default
                  extension for semaphore files is ".SEM".

                  If the user count for the specified semaphore file reaches
                  zero then the file is deleted.  The value returned
                  represents the number of users remaining for the specified
                  semaphore file (not including current user).

                  Semaphore files are normally used to signal something to
                  others on a network who are sharing the same files or
                  resources.  The intention of Sx_MakeSem() and Sx_KillSem()
                  is to provide a simple mechanism for using semaphores in
                  conjunction with indexes, as well as more generic
                  semaphore uses.

  Example:  (See the example for the Sx_MakeSem() function.)