## About security, APIs, and docs { #about-security-apis-and-docs }

Hiding your documentation user interfaces in production *shouldn't* be the way to protect your API.

That doesn't add any extra security to your API, the *path operations* will still be available where they are.

If there's a security flaw in your code, it will still exist.

    void testGetType() throws SMBProtocolDecodingException {
        // Prepare buffer with specific type value
        testBuffer[0] = 0x01; // revision
        testBuffer[1] = 0x00; // padding
        testBuffer[2] = 0x04; // type low byte
        testBuffer[3] = (byte) 0x80; // type high byte (0x8004)
        // Set all offsets to 0
        for (int i = 4; i < 20; i++) {
            testBuffer[i] = 0;

        }

        int start = dstIndex;

        // Compression count (2 bytes)
        SMBUtil.writeInt2(this.compressionAlgorithms.length, dst, dstIndex);
        dstIndex += 2;

        // Padding (2 bytes)
        SMBUtil.writeInt2(0, dst, dstIndex);
        dstIndex += 2;

        // Flags (4 bytes)
        SMBUtil.writeInt4(this.flags, dst, dstIndex);
        dstIndex += 4;

   * @return an array containing the values of {@code array}, with guaranteed minimum length {@code
   *     minLength}
   */
  public static char[] ensureCapacity(char[] array, int minLength, int padding) {
    checkArgument(minLength >= 0, "Invalid minLength: %s", minLength);
    checkArgument(padding >= 0, "Invalid padding: %s", padding);

   * @return an array containing the values of {@code array}, with guaranteed minimum length {@code
   *     minLength}
   */
  public static short[] ensureCapacity(short[] array, int minLength, int padding) {
    checkArgument(minLength >= 0, "Invalid minLength: %s", minLength);
    checkArgument(padding >= 0, "Invalid padding: %s", padding);

   * @return an array containing the values of {@code array}, with guaranteed minimum length {@code
   *     minLength}
   */
  public static short[] ensureCapacity(short[] array, int minLength, int padding) {
    checkArgument(minLength >= 0, "Invalid minLength: %s", minLength);
    checkArgument(padding >= 0, "Invalid padding: %s", padding);

 * successfully cancelled step will immediately start closing all objects captured for later closing
 * by it and by its input steps.
 *
 * <h3>Ending a pipeline</h3>
 *
 * Each {@code ClosingFuture} pipeline must be ended. To end a pipeline, decide whether you want to
 * close the captured objects automatically or manually.
 *
 * <h4>Automatically closing</h4>
 *

        int[] positions = { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 15, 16 };
        for (int pos : positions) {
            int padding = (int) pad8Method.invoke(req, pos);

            // Verify padding makes position 8-byte aligned
            assertEquals(0, (pos + padding) % 8);
        }
    }

    @Test
    @DisplayName("Should write bytes at different buffer offsets")

	msgLine2Fmt := " Update: %s "

	// Calculate length *without* color coding: with ANSI terminal
	// color characters, the result is incorrect.
	line1Length := len(fmt.Sprintf(msgLine1Fmt, newerThan))
	line2Length := len(fmt.Sprintf(msgLine2Fmt, updateString))

	// Populate lines with color coding.
	line1InColor := fmt.Sprintf(msgLine1Fmt, color.YellowBold(newerThan))

        // Check name length
        assertEquals(nameBytes.length, SMBUtil.readInt4(buffer, 8));

        // Check timeout specified flag (should be 0)
        assertEquals(0x0, buffer[12]);

        // Check padding
        assertEquals(0x0, buffer[13]);

        // Check name bytes
        byte[] encodedName = new byte[nameBytes.length];
        System.arraycopy(buffer, 14, encodedName, 0, nameBytes.length);