Add libc and OW fmemfree wrapper functions and man pages

elkscmd/man/man2/fmemalloc.2

@@ -5,6 +5,7 @@ _fmemalloc \- allocate far memory outside process
 .nf
 .ft B
 _fmemalloc(int \fIparas\fP, unsigned short *\fIpseg\fP)
+_fmemfree(unsigned short \fIseg\fP)
 .ft R
 .fi
 .SH DESCRIPTION
@@ -16,6 +17,10 @@ paragraphs of main memory
 from outside the process for use using a __far pointer within the application.
 The segment address of the memory is stored in the pointer
 .IR pseg .
+.PP
+.B _fmemfree
+frees the memory segment allocated by a previous
+.BR _fmemalloc .
 .SH "RETURN VALUE
 The value 0 is returned if no error occurs.  Otherwise,
 the call returns a negative error number.

elkscmd/man/man3/fmemalloc.3

@@ -7,6 +7,7 @@ fmemalloc \- allocate far memory outside process
 #include <stdlib.h>
 
 void __far *fmemalloc(unsigned long \fIsize\fP)
+int fmemfree(void __far *\fIptr\fP)
 .ft R
 .fi
 .SH DESCRIPTION
@@ -19,7 +20,11 @@ within the application.
 The
 .IR size
 parameter will be rounded up to the next paragraph boundary.
-
+.PP
+.B fmemfree
+frees memory allocated by a prevous
+.BR fmemalloc .
+.PP
 Any allocated memory will be automatically freed on exit from the application.
 .SH "RETURN VALUE
 The value 0 is returned if no error occurs.  Otherwise,

libc/include/watcom/syselks.h

@@ -149,6 +149,7 @@ typedef int syscall_res;
 #define SYS_setsockopt          204
 #define SYS_getsocknam          205
 #define SYS_fmemalloc           206
+#define SYS_fmemfree            207
 
 
 #define _sys_exit(rc)       sys_call1n(SYS_exit, rc)

libc/malloc/Makefile

@@ -27,6 +27,7 @@ OBJS = \
 	realloc.o \
 	sbrk.o \
 	fmemalloc.o \
+	fmemfree.o \
 
 .PHONY: all
 

libc/malloc/fmemfree.c

@@ -0,0 +1,7 @@
+#include <malloc.h>
+
+/* free from main memory */
+int fmemfree(void __far *ptr)
+{
+    return _fmemfree((unsigned short)((unsigned long)ptr >> 16));
+}

libc/watcom/syscall/fmemfree.c

@@ -0,0 +1,14 @@
+/****************************************************************************
+*
+* Description:  ELKS _fmemfree() system call.
+*
+****************************************************************************/
+
+#include <malloc.h>
+#include "watcom/syselks.h"
+
+int _fmemfree( unsigned short __seg )
+{
+    syscall_res res = sys_call1( SYS_fmemfree, __seg);
+    __syscall_return( int, res );
+}