kmem(7)                    DG/UX 4.30                     kmem(7)



     NAME
          kmem - kernel logical memory

     DESCRIPTION
          Kmem is a character special pseudo-device that provides
          access to kernel logical memory for direct reading and
          writing.  The file pointer is treated as a logical address
          within kernel logical memory.

          For the open and close system calls, user visible
          functionality is the same as for an ordinary disk file.

          With the read system call, the contents of the kernel
          logical memory at the address contained in the file  pointer
          are transferred into the caller's buffer.  If any part of
          the requested data would be out of kernel logical memory, no
          data is transferred and the error ENXIO is returned.  If any
          part of the requested data is inaccessible because of not
          being memory resident, an implementation may transfer no
          data and return the error ENXIO.  No guarantees of
          consistency are made; the kernel memory being read may
          change while the read is in progress.

          With the write system call, the contents of caller's buffer
          are transferred into the kernel logical memory at the
          address contained in the file pointer.  If the write call
          would attempt to transfer data to locations out of the
          kernel logical memory, no data will be transferred and the
          error ENXIO will be returned.  If the write call would
          attempt to transfer data to locations that are inaccessible
          because of not being memory resident, an implementation may
          transfer no data and return the error ENXIO.  Correct
          operation of the system is not guaranteed after kernel
          memory has been modified with this call.

          Select always returns READY for both read and write
          operations.

          There are no ioctl system calls specific to the character
          special device kmem. Other ioctl calls that apply to
          ordinary disk files also apply to kmem.

     FILES
          /dev/kmem

     SEE ALSO
          mem(7)








     Licensed material--property of copyright holder(s)         Page 1