bitburner-src/doc/source/netscript/advancedfunctions/getServer.rst

getServer() Netscript Function
==========================================

.. js:function:: getServer([hostname])

    :RAM cost: 2 GB
    :param string hostname: Hostname of the server, defaults to host server.

    If you are not in BitNode-5, then you must have Source-File 5-1 in order to run this function.

    This function is meant to be used in conjunction with the :doc:`formulas API<../netscriptformulasapi>`.

    Returns an object with the Server's stats. The object has the following properties::

        {
            cpuCores
            ftpPortOpen
            hasAdminRights
            hostname
            httpPortOpen
            ip
            isConnectedTo
            maxRam
            organizationName
            ramUsed
            smtpPortOpen
            sqlPortOpen
            sshPortOpen
            baseDifficulty
            hackDifficulty
            backdoorInstalled
            minDifficulty
            moneyAvailable
            moneyMax
            numOpenPortsRequired
            openPortCount
            purchasedByPlayer
            requiredHackingSkill
            serverGrowth
        }
v0.51.0 (#826) * Hash upgrades and Bladeburner skills can now be clicked to copy to clipboard * Aug purchase confirmation popup displays money in 0.000a format * Character now displays hacknet server info properly * Character,Info now displays hacknet server info correctly. * Formulas (#825) Formulas API v0.1 * Make all money the same color, same for reputation, format all numbers consistently. * rename a lot of the formulas function to no longer contain calculate * added hacking related formulas * removed unused variable * v0.51.0 2021-03-31 06:45:21 +02:00			`getServer() Netscript Function`
			`==========================================`

0518 2021-05-08 03:24:16 +02:00			`.. js:function:: getServer([hostname])`
v0.51.0 (#826) * Hash upgrades and Bladeburner skills can now be clicked to copy to clipboard * Aug purchase confirmation popup displays money in 0.000a format * Character now displays hacknet server info properly * Character,Info now displays hacknet server info correctly. * Formulas (#825) Formulas API v0.1 * Make all money the same color, same for reputation, format all numbers consistently. * rename a lot of the formulas function to no longer contain calculate * added hacking related formulas * removed unused variable * v0.51.0 2021-03-31 06:45:21 +02:00
Update netscript documentation. Unfortunately, I haven't used most of the specialty APIs yet, so I'm not intimately familiar with where their documentation might be wrong. I figured some fixes were better than no fixes, and I can always make more fixes later. Fixes #1023. 2021-07-02 23:27:59 +02:00			`:RAM cost: 2 GB`
0518 2021-05-08 03:24:16 +02:00			`:param string hostname: Hostname of the server, defaults to host server.`
v0.51.0 (#826) * Hash upgrades and Bladeburner skills can now be clicked to copy to clipboard * Aug purchase confirmation popup displays money in 0.000a format * Character now displays hacknet server info properly * Character,Info now displays hacknet server info correctly. * Formulas (#825) Formulas API v0.1 * Make all money the same color, same for reputation, format all numbers consistently. * rename a lot of the formulas function to no longer contain calculate * added hacking related formulas * removed unused variable * v0.51.0 2021-03-31 06:45:21 +02:00
			`If you are not in BitNode-5, then you must have Source-File 5-1 in order to run this function.`

			This function is meant to be used in conjunction with the :doc:`formulas API<../netscriptformulasapi>`.

			`Returns an object with the Server's stats. The object has the following properties::`

			`{`
			`cpuCores`
			`ftpPortOpen`
			`hasAdminRights`
			`hostname`
			`httpPortOpen`
			`ip`
			`isConnectedTo`
			`maxRam`
			`organizationName`
			`ramUsed`
			`smtpPortOpen`
			`sqlPortOpen`
			`sshPortOpen`
			`baseDifficulty`
			`hackDifficulty`
v0.51.6 (#905) * Make command `cd` without arguments an alias for `cd /` (#853) In most shells `cd` without arguments takes you to the home directory of the current user. I keep trying to do this due to muscle memory from working in terminals, so I figured I'd make it do something useful. There is no home directory in the game, but going to / is the closest thing we have, since that is the starting point for the user in the game. * Add new `backdoor` terminal command (#852) * Add the backdoor command to the terminal This command will perform a manual hack without rewarding money. It will be used for the story, mainly for faction hacking tests * Add tab completion for backdoor command * Add help text for backdoor command * Change condition syntax to be more consistent with others * Extract reused code block so it is always called after actions * Update documentation for new backdoor command Modified references to manual hack as it isn't for factions anymore * Remove extra parenthesis * Rename manuallyHacked to backdoorInstalled * Fix typo * Change faction test messages to use backdoor instad of hack * Rename more instances of manuallyHacked * fixed typo in helptext of darkweb buy (#858) * Fix typos and unify descriptions of augmentations (#859) Made an attempt to... - give all "+rep% company/faction" the same text - make all augmentations with a single effect use a single line to describe the effect - make all effects end with a period * Made Cashroot starter kit display its tooltip with the money formatted properly and in gold * fix typo in docs (#860) * Initial code for Casino Card Deck implementation * Casino Blackjack Implementation * Update some tools (eslint, typescript) * Blackjack code cleanup * Update README_contribution * Update ScriptHelpers.js (#861) expand error message * More augmentation typo fixes (#862) * Add Netscript function getCurrentScript (#856) Add netscript function that returns the current script. * Added milestones menu to guide new players. (#865) Milestone menu * fix typos in milestones (#866) Co-authored-by: sschmidTU <s.schmid@phonicscore.com> * Corrupt location title when backdoor is installed (#864) * Add corruptableText component * Corrupt location title if backdoor is installed * Formatting * Add helper to check value of backdoorInstalled Helper could be oneline but it would make it less readable * Fix some formatting * Add settings option to disable text effects * Import useState * getRunningScript (#867) * Replaced getCurrentScript with getRunningScript * Bunch of smaller fixes (#904) Fix #884 Fix #879 Fix #878 Fix #876 Fix #874 Fix #873 Fix #887 Fix #891 Fix #895 * rework the early servers to be more noob friendly (#903) * v0.51.6 Co-authored-by: Andreas Eriksson <2691182+AndreasTPC@users.noreply.github.com> Co-authored-by: Jack <jackdewinter1@gmail.com> Co-authored-by: Teun Pronk <5228255+Crownie88@users.noreply.github.com> Co-authored-by: Pimvgd <Pimvgd@gmail.com> Co-authored-by: Daniel Xie <daniel.xie@flockfreight.com> Co-authored-by: Simon <33069673+sschmidTU@users.noreply.github.com> Co-authored-by: sschmidTU <s.schmid@phonicscore.com> 2021-04-29 02:07:26 +02:00			`backdoorInstalled`
v0.51.0 (#826) * Hash upgrades and Bladeburner skills can now be clicked to copy to clipboard * Aug purchase confirmation popup displays money in 0.000a format * Character now displays hacknet server info properly * Character,Info now displays hacknet server info correctly. * Formulas (#825) Formulas API v0.1 * Make all money the same color, same for reputation, format all numbers consistently. * rename a lot of the formulas function to no longer contain calculate * added hacking related formulas * removed unused variable * v0.51.0 2021-03-31 06:45:21 +02:00			`minDifficulty`
			`moneyAvailable`
			`moneyMax`
			`numOpenPortsRequired`
			`openPortCount`
			`purchasedByPlayer`
			`requiredHackingSkill`
			`serverGrowth`
			`}`