bitburner-src/doc/source/netscript/basicfunctions/weaken.rst

weaken() Netscript Function
===========================

.. js:function:: weaken(hostname/ip, options={})

    :param string hostname/ip: IP or hostname of the target server to weaken
    :param object options: Optional parameters for configuring function behavior. Properties:

        * threads (*number*) - Number of threads to use for this function.
          Must be less than or equal to the number of threads the script is running with.

    :returns: The amount by which the target server's security level was decreased. This is equivalent to 0.05 multiplied
              by the number of script threads
    :RAM cost: 0.15 GB

    Use your hacking skills to attack a server's security, lowering the server's security level. The runtime for this command
    depends on your hacking level and the target server's security level. This function lowers the security level of the target
    server by 0.05.

    Like hack() and grow(), weaken() can be called on any server, regardless of where the script is running. This command requires
    root access to the target server, but there is no required hacking level to run the command.

    Example::

        weaken("foodnstuff");
        weaken("foodnstuff", { threads: 5 }); // Only use 5 threads to weaken