/**
 * File System Control Code (FSCC) structure for File End-of-File Information.
 * Used in SMB2/SMB3 operations to set or query the end-of-file position for a file,
 * effectively controlling file size truncation or extension.
 *
 * @author mbechler
 */
public class FileEndOfFileInformation implements FileInformation, Encodable {

    private long endOfFile;

    /**
     * Default constructor for decoding.

        assertEquals("teststring", InputValidator.sanitizeForLogging("test\rstring"));
        assertEquals("teststring", InputValidator.sanitizeForLogging("test\tstring"));

        // Test long string truncation
        String longString = "a".repeat(1100);
        String sanitized = InputValidator.sanitizeForLogging(longString);
        assertEquals(1000, sanitized.length());
        assertTrue(sanitized.endsWith("..."));

        SMBUtil.writeInt2(128, buffer, 56); // Security buffer offset
        // writeInt2(100000) will truncate to 100000 & 0xFFFF = 34464
        SMBUtil.writeInt2(100000, buffer, 58); // This becomes 34464 due to 16-bit truncation

        // Since 34464 is within the 16-bit range but could still be considered excessive for security buffer,
        // let's test the actual validation logic instead

                eq(RequestParam.NO_RETRY));
    }

    @Test
    @DisplayName("setLength(): legacy path uses SmbComWrite for truncation")
    void setLength_legacy_usesComWrite() throws Exception {
        SmbRandomAccessFile raf = newInstance("rw", false, false, false);
        SmbFileHandleImpl fh = (SmbFileHandleImpl) getField(raf, "handle");

                        new Trans2SetFileInformationResponse(th.getConfig()), RequestParam.NO_RETRY);
            } else {
                // this is the original, COM_WRITE allows truncation but no 64 bit offsets
                final SmbComWriteResponse rsp = new SmbComWriteResponse(th.getConfig());

        // The BigInteger implementation is tested separately, use it as the reference.
        // Promote the int value (rather than using intValue() on the expected value) to avoid
        // any risk of truncation which could lead to a false positive.
        assertEquals(BigIntegerMath.sqrt(valueOf(x), mode), valueOf(IntMath.sqrt(x, mode)));
      }
    }
  }

  /* Relies on the correctness of sqrt(int, FLOOR). */

   */
  @VisibleForTesting
  static int optimalNumOfHashFunctions(double p) {
    // -log(p) / log(2), ensuring the result is rounded to avoid truncation.
    return max(1, (int) Math.round(-Math.log(p) / LOG_TWO));
  }

  /**
   * Computes m (total bits of Bloom filter) which is expected to achieve, for the specified

    /** Pattern for matching shared folder paths */
    protected static final Pattern SHARED_FOLDER_PATTERN = Pattern.compile("^file:/+[^/]\\.");

    /** Ellipsis string for text truncation */
    protected static final String ELLIPSIS = "...";

    /** Whether to encode URL links */
    protected boolean encodeUrlLink = false;

    /** Character encoding for URL links */

      RangeMapEntry<K, V> rangeMapEntry = mapEntryAboveToTruncate.getValue();
      if (rangeMapEntry.getUpperBound().compareTo(rangeToRemove.upperBound) > 0) {
        // we know ( ] ), and since we dealt with truncating below already,
        // we know [ ( ] )
        putRangeMapEntry(
            rangeToRemove.upperBound,
            rangeMapEntry.getUpperBound(),
            mapEntryAboveToTruncate.getValue().getValue());

   * truncated before writing. When the {@link FileWriteMode#APPEND APPEND} mode is provided, writes
   * will append to the end of the file without truncating it.
   *
   * @since 14.0
   */
  public static ByteSink asByteSink(File file, FileWriteMode... modes) {
    return new FileByteSink(file, modes);
  }