/*
 *  Licensed to the Apache Software Foundation (ASF) under one or more
 *  contributor license agreements.  See the NOTICE file distributed with
 *  this work for additional information regarding copyright ownership.
 *  The ASF licenses this file to You under the Apache License, Version 2.0
 *  (the "License"); you may not use this file except in compliance with
 *  the License.  You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 */

package org.apache.tomcat.jni;

Stdlib
Author:Mladen Turk
Deprecated: The scope of the APR/Native Library will be reduced in Tomcat 10.1.x onwards to only those components required to provide OpenSSL integration with the NIO and NIO2 connectors.
/** Stdlib * * @author Mladen Turk * * @deprecated The scope of the APR/Native Library will be reduced in Tomcat * 10.1.x onwards to only those components required to provide * OpenSSL integration with the NIO and NIO2 connectors. */
@Deprecated public class Stdlib {
Read from plain memory
Params:
  • dst – Destination byte array
  • src – Source memory address
  • sz – Number of bytes to copy.
Returns:true if the operation was successful
/** * Read from plain memory * @param dst Destination byte array * @param src Source memory address * @param sz Number of bytes to copy. * @return <code>true</code> if the operation was successful */
public static native boolean memread(byte [] dst, long src, int sz);
Write to plain memory
Params:
  • dst – Destination memory address
  • src – Source byte array
  • sz – Number of bytes to copy.
Returns:true if the operation was successful
/** * Write to plain memory * @param dst Destination memory address * @param src Source byte array * @param sz Number of bytes to copy. * @return <code>true</code> if the operation was successful */
public static native boolean memwrite(long dst, byte [] src, int sz);
Sets buffers to a specified character
Params:
  • dst – Destination memory address
  • c – Character to set.
  • sz – Number of characters.
Returns:true if the operation was successful
/** * Sets buffers to a specified character * @param dst Destination memory address * @param c Character to set. * @param sz Number of characters. * @return <code>true</code> if the operation was successful */
public static native boolean memset(long dst, int c, int sz);
Allocates memory blocks.
Params:
  • sz – Bytes to allocate.
Returns:a pointer
/** * Allocates memory blocks. * @param sz Bytes to allocate. * @return a pointer */
public static native long malloc(int sz);
Reallocate memory blocks.
Params:
  • mem – Pointer to previously allocated memory block.
  • sz – New size in bytes.
Returns:a pointer
/** * Reallocate memory blocks. * @param mem Pointer to previously allocated memory block. * @param sz New size in bytes. * @return a pointer */
public static native long realloc(long mem, int sz);
Allocates an array in memory with elements initialized to 0.
Params:
  • num – Number of elements.
  • sz – Length in bytes of each element.
Returns:a pointer
/** * Allocates an array in memory with elements initialized to 0. * @param num Number of elements. * @param sz Length in bytes of each element. * @return a pointer */
public static native long calloc(int num, int sz);
Deallocates or frees a memory block.
Params:
  • mem – Previously allocated memory block to be freed.
/** * Deallocates or frees a memory block. * @param mem Previously allocated memory block to be freed. */
public static native void free(long mem);
Get current process pid.
Returns:current pid or < 1 in case of error.
/** * Get current process pid. * @return current pid or &lt; 1 in case of error. */
public static native int getpid();
Get current process parent pid.
Returns:parent pid or < 1 in case of error.
/** * Get current process parent pid. * @return parent pid or &lt; 1 in case of error. */
public static native int getppid(); }