git.pond.sub.org Git - empserver/blob - info/sdump.t

   1 .TH Command SDUMP
   2 .NA sdump "Dump raw ship information"
   3 .LV Expert
   4 .SY "sdump <SHIPS> [<fields>]"
   5 The sdump command displays all information on
   6 some or all of your ships.
   7 sdump is a combination of ship, cargo, and sstat.
   8 Each ship's information is printed on one very long line.
   9 Fields are separated by a single space.
  10 .s1
  11 This command is designed to be used for input to an empire tool
  12 such as \*Qve\*U.
  13 .s1
  14 In the syntax of the sdump command
  15 <SHIPS> are the ships on which you wish information,
  16 [<fields>] are the fields you wish to dump.
  17 If no fields are specified, all fields are printed.
  18 (see \*Qinfo Syntax\*U).
  19 .s1
  20 An sdump command lists all selected ships headed by:
  21 .NF
  22 Sun Feb  9 22:16:37 1997
  23 DUMP SHIPS 855544597
  24 <fields>
  25 .FI
  26 The first line is the date.  The second line is the
  27 "DUMP SHIPS <timestamp>" where the <timestamp> field is the current
  28 timestamp.  The third line is the columns which are output.
  29 .s1
  30 These columns represent the following fields which are also the
  31 selection criteria for the command.
  32 .s1
  33 The following may be used as fields.  They must be entered EXACTLY as
  34 shown here (no partial pattern matching is done.)
  35 .NF
  36    type    type of ship
  37    x       x location
  38    y       y location
  39    flt     fleet
  40    eff     efficiency
  41    civ     # of civilians on board
  42    mil     # of mil on board
  43    uw      # of uw on board
  44    food    # of food on board
  45    pln     # of planes on board
  46    he      # of helicopters on board
  47    xl      # of x-light planes on board
  48    land    # of land units on board
  49    mob     mobility
  50    fuel    obsolete, retained for backwards compatibility, always zero
  51    tech    technology of ship
  52    shell   # of shells on board
  53    gun     # of guns on board
  54    petrol  # of petrol on board
  55    iron    # of iron on board
  56    dust    # of dust on board
  57    bar     # of bars on board
  58    oil     # of oil on board
  59    lcm     # of lcms on board
  60    hcm     # of hcms on board
  61    rad     # or rads on board
  62    def     defense of ship
  63    spd     speed of ship
  64    vis     visibility of ship
  65    rng     firing range of ship
  66    fir     max # of guns fired by each volley
  67    name    ship name
  68    origx   x origin where trade ship was built
  69    origy   y origin where trade ship was built
  70 .FI
  71 .s1
  72 A typical usage might be:
  73 .EX sdump #5
  74 which would list data for all ships in realm #5.
  75 .s1
  76 A sdump lists each of your ships in the specified area.
  77 The header line is a list of fields that correspond
  78 to the order that sdump prints the ship info.
  79 .s1
  80 .SA "ship, cargo, sstat, xdump, Ships"