*   public boolean isDone() {
   *     return ref.get() == null;
   *   }
   * });
   * }
   *
   * @throws RuntimeException if timed out or interrupted while waiting
   */
  public static void awaitClear(WeakReference<?> ref) {
    awaitDone(() -> ref.get() == null);
  }

  /**
   * Tries to perform a "full" garbage collection cycle (including processing of weak references and

        Map<String, Object> docMap = new HashMap<>();
        docMap.put("id", "doc123");

        // Since createTask depends on FessConfig, it may not work properly
        // in unit tests without full container
        try {
            generator.createTask("/path/to/thumb.jpg", docMap);
        } catch (Exception e) {
            // Expected when FessConfig is not available
        }
    }

import java.io.EOFException
import java.net.InetAddress
import java.net.UnknownHostException
import okio.Buffer
import okio.ByteString
import okio.utf8Size

/**
 * Trivial Dns Encoder/Decoder, basically ripped from Netty full implementation.
 */
internal object DnsRecordCodec {
  private const val SERVFAIL = 2
  private const val NXDOMAIN = 3
  const val TYPE_A = 0x0001
  const val TYPE_AAAA = 0x001c
  private const val TYPE_PTR = 0x000c

    /** No mapping between account names and security IDs was done */
    int NT_STATUS_NONE_MAPPED = 0xC0000073;
    /** The security ID structure is invalid */
    int NT_STATUS_INVALID_SID = 0xC0000078;
    /** The disk is full */
    int NT_STATUS_DISK_FULL = 0xC000007f;
    /** Insufficient resources are available to complete the request */
    int NT_STATUS_INSUFFICIENT_RESOURCES = 0xC000009a;

 * </ul>
 *
 * @since 4.0.0
 */
@Experimental
public interface OsService extends Service {
    /**
     * Returns the OS full name as reported by the system property "os.name".
     * The value is converted to lowercase for consistency.
     *
     * @return the operating system name (never null)
     */
    @Nonnull
    String name();

    /**
     * Returns the OS architecture as reported by the system property "os.arch".

   * Sec-CH-UA-Full-Version}</a> header field name.
   *
   * @deprecated Prefer {@link SEC_CH_UA_FULL_VERSION_LIST}.
   * @since 30.0
   */
  @Deprecated public static final String SEC_CH_UA_FULL_VERSION = "Sec-CH-UA-Full-Version";

  /**
   * The HTTP <a href="https://wicg.github.io/ua-client-hints/#sec-ch-ua-full-version-list">{@code

 * a handle after network failures or server reboots.
 */
public class HandleInfo implements Serializable {

    private static final long serialVersionUID = 1L;

    /**
     * The full path to the file or directory associated with this handle
     */
    private final String path;

    /**
     * The create GUID used to uniquely identify this handle for reconnection
     */

    static Stream<Arguments> byteEncodableArgs() {
        return Stream.of(
                // srcLen, off, len, dstIndex
                Arguments.of(makeSeq(8), 0, 8, 0), // full copy at index 0
                Arguments.of(makeSeq(10), 2, 5, 3), // middle slice, non-zero dst index
                Arguments.of(makeSeq(4), 4, 0, 0), // zero-length slice at end

        if (path == null || path.isEmpty()) {
            // TODO This replacing shouldn't be necessary as user.home should be in the
            // context of the container and thus the value would be interpolated by Plexus
            String basedir = System.getProperty(basedirSysProp);
            if (basedir == null) {
                basedir = System.getProperty("user.dir");
            }

     * for finalName directly in the plugin configuration section. It is also useful to ensure that - for example - a
     * List-typed parameter which expects items of type Artifact doesn't get a List full of Strings.
     *
     * @return <code>true</code> if the user should not be allowed to configure the parameter directly
     */
    boolean readonly() default false;