1FGFS(1) FlightGear man pages FGFS(1)
2
6 fgfs - the FlightGear flight simulator
7
9 fgfs [options...]
10
12 fgfs is the main executable for FlightGear, a free, open-source, multi-
13 platform and sophisticated flight simulator framework for the develop‐
14 ment and pursuit of interesting flight simulator ideas.
15
17 Options are first read from the command-line arguments passed to fgfs.
18 The program then checks for the existence of ~/.fgfsrc.hostname (where
19 hostname is the hostname of the machine) and of ~/.fgfsrc; if at least
20 one of those files exists, it is read and parsed (see the fgfsrc(5) man
21 page for the full specifications of the file format).
22 If conflicting options are given, the ones read last will prevail.
24 General options
27 --help, -h
28 Display usage information about the most relevant command-line
29 options and exit.
30 --verbose, -v
32 When combined with --help/-h, display usage information about
33 all command-line options, not just the most relevant ones.
34 --version
36 Display version information about fgfs and some of the libraries
37 used by the program (SimGear, OpenSceneGraph, PLIB), then exit.
38 --fg-root=path
40 Set the FlightGear data root directory ($FG_ROOT) to path. If
41 this option is not set, fgfs uses the path specified in the
42 FG_ROOT environment variable or, absent that, the FlightGear
43 data directory chosen at the time the program was compiled.
44 --fg-scenery=path
46 Set the FlightGear scenery directories ($FG_SCENERY) to path.
47 You can specify multiple directories by separating them with
49 colons (:), as in /first/path:/second/path (on Microsoft Windows
50 operating systems, multiple paths should be separated by semi‐
51 colons instead): in that case, fgfs will follow the order the
52 paths are written in to search for scenery files, stopping as
53 soon as a match is found.
54 If this option is not set, fgfs uses the path specified in the
56 FG_SCENERY environment variable or, absent that, the Scenery
57 subdirectory inside $FG_ROOT.
58 --fg-aircraft=path
60 Load additional aircraft from path besides the Aircraft subdi‐
61 rectory inside $FG_ROOT. Alternatively, you can use --air‐
62 craft-dir to target a specific aircraft in a given directory.
63 --download-dir=path
65 Store aircraft and scenery downloaded via the simulator in path.
66 The TerraSync directory may be specifically set with the --ter‐
68 rasync-dir option.
69 --allow-nasal-read=dirs
71 Allow Nasal aircraft scripts to read files from the directories
72 listed in dirs (separate multiple paths with colons, or semi‐
73 colons on Microsoft Windows operating systems).
74 By default, Nasal scripts are allowed to read data only from
76 $FG_ROOT and $FG_HOME, as a security measure.
77 --read-only
79 Make $FG_HOME (the location where user-specific FlightGear data
80 is stored) read-only.
81 --language=code
83 Set the language used by the simulator to code, where code is an
84 ISO 639-1 two-letter locale code (for example, en or it).
85 --restore-defaults
87 Reset all user settings to their defaults.
88 --enable-save-on-exit, --disable-save-on-exit
90 Save/do not save user settings when the program exits.
91 --ignore-autosave
93 Ignore the user settings saved the previous time FlightGear was
94 run. This option implies --disable-save-on-exit.
95 --browser-app=path
97 Use the Web browser specified in path to open aircraft documen‐
98 tation.
99 --prop:[type:]name=value
101 Set the property name to value. You can optionally specify the
102 property type by setting type to string, double, float, long,
103 int or bool.
104 --config=path
106 Load additional configuration directives from path. The file
107 should follow the format described in fgfsrc(5).
108 --no-default-config
110 Do not load any configuration files unless they were explicitly
111 specified with --config.
112 --units-feet
114 Use feet as the internal measure unit for distances.
115 --units-meters
117 Use meters as the internal measure unit for distances.
118 --console
120 Display a console window for simulator/aircraft debugging pur‐
121 poses.
122 This option is recognized only on Microsoft Windows operating
124 systems; on other systems, debug messages are always printed to
125 standard output/standard error.
126 --launcher
128 Start the FlightGear Launcher, a graphical Qt-based interface to
129 the simulator.
130 This option is available only if FlightGear was compiled with Qt
132 support enabled.
133 --json-report
135 Print a report in JSON format on the standard output. The report
136 will give useful information for debugging purposes, such as the
137 FlightGear version, the scenery/aircraft paths in use, the Ter‐
138 raSync and the data download directories and the paths to navi‐
139 gation data files.
140 Features
142 --enable-panel, --disable-panel
143 Enable/disable the pop-up aircraft instrument panel if the cho‐
144 sen airplane has it.
145 --enable-hud, --disable-hud
147 Enable/disable the heads-up display (HUD) if the chosen airplane
148 has it.
149 --enable-anti-alias-hud, --disable-anti-alias-hud
151 Enable/disable heads-up display antialiasing.
152 --enable-hud-3d, --disable-hud-3d
154 Enable/disable the 3D version of the heads-up display.
155 --hud-tris
157 Display the number of triangles rendered when painting the
158 heads-up display.
159 --hud-culled
161 Display the number of triangles culled when painting the heads-
162 up display.
163 --enable-random-objects, --disable-random-objects
165 Show/hide random scenery objects, such as buildings. Scenery
166 objects increase realism, but require more resources (memory and
167 graphic card power).
168 --enable-random-vegetation, --disable-random-vegetation
170 Show/hide random vegetation.
171 --enable-random-buildings, --disable-random-buildings
173 Show/hide random buildings.
174 --enable-ai-models, --disable-ai-models
176 Enable/disable the internal AI subsystem, which is required for
177 multiplayer gaming, AI traffic and many other animations. Dis‐
178 abling the internal AI subsystem is deprecated.
179 --enable-ai-traffic, --disable-ai-traffic
181 Enable/disable artificial plane traffic.
182 --ai-scenario=scenario
184 Add and enable the AI scenario scenario. This option may be
185 repeated multiple times to enable multiple scenarios.
186 --enable-freeze
188 Start the simulator in a frozen (paused) state.
189 --disable-freeze
191 Start the simulator in a running (unpaused) state.
192 --enable-fuel-freeze
194 Do not consume any fuel (keep its quantity in the tanks con‐
195 stant).
196 --disable-fuel-freeze
198 Consume fuel normally.
199 --enable-clock-freeze
201 Do not let the clock advance while running the simulation.
202 --disable-clock-freeze
204 Let the clock advance normally.
205 --failure=pitot|static|vacuum|electrical
207 Fail the aircraft pitot, static, vacuum or electrical systems.
208 This option may be repeated multiple times to fail more than one
209 system.
210 --load-tape=tape
212 Load and replay the flight recorder tape tape.
213 Audio options
215 --show-sound-devices
216 Show a list of available audio devices and exit.
217 --sound-device=name
219 Set the sound device to use to name, where name is the device
220 name shown by the --show-sound-devices option.
221 --enable-sound, --disable-sound
223 Enable/disable sound in the simulator.
224 Rendering options
226 --terrain-engine=tilecache|pagedLOD
227 Choose the terrain engine to use. tilecache is the "traditional"
228 terrain engine (recommended); pagedLOD is a new, experimental
229 terrain engine designed to minimize memory usage by loading more
230 detailed versions of scenery objects on demand.
231 The pagedLOD engine is available only if FlightGear was compiled
233 with GDAL support.
234 --lod-levels=levels
236 Set the level of detail levels to levels, where levels is a
237 space-separated list of numeric levels. This option is available
238 only if the terrain engine in use is pagedLOD.
239 --lod-res=resolution
241 Set the terrain mesh resolution to resolution. This option is
242 available only if the terrain engine in use is pagedLOD.
243 --lod-texturing=bluemarble|raster|debug
245 Set the terrain texture method. This option is available only if
246 the terrain engine in use is pagedLOD.
247 --lod-range-mult=multiplier
249 Set the range multiplier (the breakpoint from a low to a high
250 level of detail) to multiplier. This option is available only if
251 the terrain engine in use is pagedLOD.
252 --enable-rembrandt, --disable-rembrandt
254 Enable/disable the Rembrandt engine ⟨http://wiki.flightgear.org/
255 Project_Rembrandt⟩, which adds deferred shading (rendering all
256 properties of an object, such as shading, lighting, fog) in more
257 than one pass.
258 --renderer=name
260 If the Rembrandt engine is enabled, use the rendering pipeline
261 described in $FG_ROOT/Effects/name.xml.
262 --enable-splash-screen, --disable-splash-screen
264 Show/hide the simulator splash screen while loading the air‐
265 craft/scenery.
266 --enable-mouse-pointer, --disable-mouse-pointer
268 Force enable display/do not force display the mouse pointer at
269 startup.
270 --max-fps=frequency
272 Limit the maximum frame rate of the simulator to frequency Hz
273 (frames per second).
274 --bpp=depth
276 Use a color depth of depth bits per pixel to display the air‐
277 craft and scenery.
278 --fog-disable, --fog-fastest, --fog-nicest
280 Choose the fog/haze rendering technique. --fog-disable will
281 disable fog/haze entirely; --fog-fastest will explicitly ask the
282 graphics card driver to choose the most efficient, but possibly
283 less accurate, fog/haze rendering algorithm; --fog-nicest will
284 leave the algorithm choice to the driver, leading to higher
285 quality results.
286 --enable-enhanced-lighting, --disable-enhanced-lighting
288 Enable/disable enhanced runway lighting. This option is depre‐
289 cated.
290 --enable-distance-attenuation, --disable-distance-attenuation
292 Enable/disable runway light distance attenuation (the runway
293 lights become less intense as distance increases).
294 --enable-horizon-effect, --disable-horizon-effect
296 Enable/disable the celestial body growth illusion near the hori‐
297 zon.
298 --enable-specular-highlight, --disable-specular-highlight
300 Enable/disable specular reflections on textured objects.
301 --fov=degrees
303 Set the field of view angle (FOV) to degrees. High field of view
304 angles allow you to see a wider part of the world; low angles
305 allow you to "zoom in" on details.
306 --aspect-ratio-multiplier=factor
308 Set the horizontal and vertical aspect ratio multiplier to fac‐
309 tor.
310 --enable-fullscreen, --disable-fullscreen
312 Enable/disable fullscreen mode.
313 --shading-flat, --shading-smooth
315 Use flat/smooth shading. If flat shading is active, the simula‐
316 tor uses the same color to paint the face of an object: this is
317 faster, but makes edges more pronounced. Smooth shading smooths
318 color changes between vertices, leading to higher-quality
319 results, at an expense in performance.
320 --materials-file=file
322 Load the definitions of the materials used to render the scenery
323 from file. By default, materials are loaded from
324 $FG_ROOT/regions/materials.xml.
325 --texture-filtering=value
327 Set the anisotropic texture filtering to value. The acceptable
328 values are 1 (default), 2, 4, 8 or 16.
329 --enable-wireframe, --disable-wireframe
331 Enable/disable the wireframe drawing mode (in which only object
332 edges are painted).
333 --geometry=widthxheight
335 Set the window geometry (size) to widthxheight (both width and
336 height are in pixels).
337 --view-offset=LEFT|RIGHT|CENTER|value
339 Specify the default forward view direction as an offset from
340 straight ahead. The allowed values are LEFT (-90°), RIGHT
341 (90°), CENTER (0°) or a specific number in degrees.
342 Aircraft options
344 --aircraft=name, --vehicle=name
345 Load an aircraft/vehicle from a set file named name-set.xml. The
346 file is searched for in $FG_ROOT/Aircraft, in the directory
347 pointed to by the environment variable FG_AIRCRAFT and in the
348 directories passed to fgfs(1) using the --fg-aircraft option.
349 --aircraft-dir=path
351 Explicitly specify the directory in which the -set.xml file
352 should be searched for. If this argument is used, the path cache
353 stored in ~/.fgfs/autosave_X_Y.xml, the directories passed with
354 the --fg-aircraft option and the directory specified in the
355 FG_AIRCRAFT environment variable are not taken into account.
356 --show-aircraft
358 Print a list of available aircraft and exit.
359 --min-status=alpha|beta|early-production|production
361 Do not list aircraft having a status level (development status)
362 lower than the one specified. See the FlightGear wiki "Aircraft
363 rating system" page ⟨http://wiki.flightgear.org/
364 Aircraft_rating_system⟩ for an extended description of aircraft
365 ratings.
366 --fdm=jsb|larcsim|yasim|magic|balloon|ada|external|null
368 Select the core flight dynamics model to use among the following
369 ones:
370 · jsb: the JSBSim flight dynamics model ⟨http://
372 www.jsbsim.org/⟩, which takes a data-driven approach to mod‐
373 eling: given the performance data for an aircraft (mass and
374 balance, ground reactions, propulsions, aerodynamics...), it
375 assembles it together to produce the global aircraft dynam‐
376 ics;
377 · larcsim: the LaRCsim flight dynamics model ⟨http://
379 www.jsbsim.org/⟩, the original model used in FlightGear up to
380 2000, developed at NASA, now inactive;
381 · yasim: the YASim flight dynamics model ⟨http://
383 wiki.flightgear.org/YASim⟩, which, given the physical and
384 flying characteristics of an aircraft, attempts to solve for
385 them;
386 · magic: the "Magic Carpet" flight model;
388 · balloon: a hot air balloon simulation;
390 · ada: an externally-driven flight dynamics model designed by
392 the Aeronautical Development Agency of Bangalore, India;
393 · external/null: use an external flight dynamics model (the
395 external option has the same meaning as null and is main‐
396 tained for backward compatibility purposes).
397 --aero=name
399 Load the aircraft aerodynamics model from the file name.xml in
400 the aircraft directory.
401 --model-hz=n
403 Run the flight dynamics model at a frequency of n Hz (n times
404 per second).
405 --speed=n
407 Run the flight dynamics model n times faster than real time.
408 --trim, --notrim
410 Trim/do not attempt to trim the model. This option is only valid
411 if the flight dynamics module in use is JSBSim.
412 --on-ground
414 Start the aircraft on the ground. This is the default option.
415 --in-air
417 Start the aircraft in the air. This option is implied if --alti‐
418 tude is specified.
419 --enable-auto-coordination, --disable-auto-coordination
421 Enable/disable auto coordination (joint control of rudder and
422 ailerons).
423 --livery=name
425 Load the aircraft livery from a file named name.
426 --state=value
428 Set the initial aircraft state to value. The states that can be
429 used are aircraft-dependent.
430 Time options
432 --timeofday=real|dawn|morning|noon|afternoon|dusk|evening|midnight
433 Start the simulator at the specified time of day:
434 · real: real clock time;
436 · dawn: the time when the Sun is 90° E on the horizon;
438 · morning: the time when the Sun is 75° E on the horizon;
440 · noon: the time when the Sun is 0° on the horizon;
442 · afternoon: the time when the Sun is 75° W on the horizon;
444 · dusk: the time when the Sun is 90° W on the horizon;
446 · evening: the time when the Sun is 100° W on the horizon;
448 · midnight: the time when the Sun is 180° on the horizon.
450 --season=summer|winter
452 Load summer/winter textures.
453 --time-offset=[+|-]hh:mm:ss
455 Add a time offset to the startup time specified with the --time‐
456 ofday option.
457 --time-match-real
459 Synchronize the simulator time with real world GMT time.
460 --time-match-local
462 Synchronize the simulator time with real world local time.
463 --start-date-sys=yyyy:mm:dd:hh:mm:ss
465 Specify the simulator starting date and time with respect to the
466 local timezone of the system.
467 --start-date-gmt=yyyy:mm:dd:hh:mm:ss
469 Specify the simulator starting date and time with respect to the
470 Greenwich Mean Time.
471 --start-date-lat=yyyy:mm:dd:hh:mm:ss
473 Specify the simulator starting date and time with respect to the
474 timezone of the starting airport.
475 Initial position and orientation
477 --airport=ID
478 Start the simulator at the airport having ID as its ICAO code.
479 --parking-id=name
481 Place the aircraft at the parking position name. This option
482 requires the --airport option to be present.
483 --runway=number
485 Place the aircraft on runway number. This option requires the
486 --airport option to be present.
487 --carrier=name|ID
489 Place the aircraft on the AI carrier named name/having the ID
490 ID.
491 --parkpos=name
493 Place the aircraft at the starting position name. This option
494 requires the --carrier option to be present.
495 --vor=ID
497 Place the aircraft over the VOR ID.
498 --vor-frequency=frequency
500 Set the frequency of the VOR to frequency. This option requires
501 the --vor option to be present.
502 --ndb=ID
504 Place the aircraft over the NDB ID.
505 --ndb-frequency=frequency
507 Set the frequency of the NDB to frequency. This option requires
508 the --ndb option to be present.
509 --fix=ID
511 Place the aircraft over the fix ID.
512 --offset-distance=nm
514 Place the aircraft nm statute miles away from the reference
515 point specified by the previous options.
516 --offset-azimuth=degrees
518 Place the aircraft at a heading of degrees degrees with respect
519 to the reference point specified by the previous options.
520 --lon=degrees, --lat=degrees
522 Place the aircraft at the point with the coordinates (lat, lon).
523 Northern longitudes/eastern latitudes must be positive; southern
524 longitudes/western latitudes must be negative.
525 --altitude=value
527 Place the aircraft at an altitude of value feet (meters if the
528 --units-meters option was specified).
529 --heading=degrees
531 Specify the initial heading (yaw) angle (psi) of the aircraft.
532 --roll=degrees
534 Specify the initial roll angle (phi) of the aircraft.
535 --pitch=degrees
537 Specify the initial pitch angle (theta) of the aircraft.
538 --uBody=units_per_sec
540 Specify the initial velocity along the body X axis.
541 --vBody=units_per_sec
543 Specify the initial velocity along the body Y axis.
544 --wBody=units_per_sec
546 Specify the initial velocity along the body Z axis.
547 --vNorth=units_per_sec
549 Specify the initial velocity along the body North-South axis.
550 --vEast=units_per_sec
552 Specify the initial velocity along the body West-East axis.
553 --vDown=units_per_sec
555 Specify the initial velocity along the body vertical axis.
556 --vc=knots
558 Set the initial airspeed of the aircraft to knots knots.
559 --mach=number
561 Set the initial airspeed of the aircraft to Mach number.
562 --glideslope=degrees
564 Set the flight path angle to degrees degrees. The value can be
565 positive.
566 --roc=fpm
568 Set the initial rate of climb to fpm feet per minute. The value
569 can be negative.
570 Route/waypoint options
572 --wp=ID[@alt]
573 Enter the waypoint (VOR, NDB, fix) ID into the autopilot. The
574 optional part @alt can be used to specify the altitude at which
575 ID should be crossed.
576 --flight-plan=file
578 Read a flight plan from file.
579 Avionics options
581 --com1=frequency
582 Set the COM1 frequency to frequency MHz.
583 --com2=frequency
585 Set the COM2 frequency to frequency MHz.
586 --nav1=[radial:]frequency
588 Set the NAV1 frequency to frequency MHz. You can optionally
589 specify a radial by prefixing the frequency with the heading and
590 a colon.
591 --nav2=[radial:]frequency
593 Set the NAV2 frequency to frequency MHz. You can optionally
594 specify a radial by prefixing the frequency with the heading and
595 a colon.
596 --adf1=[rotation:]frequency, --adf=[rotation:]frequency
598 Set the ADF1 frequency to frequency kHz. You can optionally
599 specify the rotation angle of its compass card by prefixing the
600 frequency with the angle and a colon. The --adf option is depre‐
601 cated.
602 --adf2=[rotation:]frequency
604 Set the ADF2 frequency to frequency kHz. You can optionally
605 specify the rotation angle of its compass card by prefixing the
606 frequency with the angle and a colon.
607 --dme=nav1|nav2|frequency
609 Slave the automatic direction finder to the NAV1/NAV2 radio or
610 set its internal frequency to frequency.
611 Environment options
613 --metar=METAR
614 Simulate the weather conditions described by the METAR string
615 METAR. This option implies --disable-real-weather-fetch.
616 --enable-real-weather-fetch, --disable-real-weather-fetch
618 Enable/disable METAR-based real weather fetching. This feature
619 requires an active Internet connection.
620 --enable-clouds, --disable-clouds
622 Enable/disable 2D (flat) cloud layers.
623 --enable-clouds3d, --disable-clouds3d
625 Enable/disable 3D (volumetric) cloud layers.
626 --visibility=meters
628 Set the initial visibility to meters meters.
629 --visibility-miles=miles
631 Set the initial visibility to miles miles.
632 --wind=dir[:maxdir]@speed[:gust]
634 Specify the direction the wind blows from (dir) and its speed
635 (speed knots). If the wind is not meant to blow from a fixed
636 direction, but rather from a range of directions, specify the
637 range as dir:maxdir, where dir and maxdir are the minimum and
638 maximum angles in degrees. If you want the simulator to model
639 wind gusts as well, set gust to their maximum intensity in
640 knots.
641 --random-wind
643 Randomize the direction and speed of the wind.
644 --turbulence=intensity
646 Set the turbulence intensity to intensity. The intensity can
647 range from 0.0 (calm) to 1.0 (severe).
648 --ceiling=ft_asl[:thickness_ft]
650 Create an overcast ceiling at a height of ft_asl feet above the
651 mean sea level. You can optionally specify a thickness by
652 appending a colon (:) and the desired thickness in feet; if you
653 omit it, the simulator will default to 2000 ft.
654 Network options
656 --callsign=value
657 Set the multiplayer callsign to value. The callsign must be at
658 most ten characters long and must contain only numbers, letters
659 of the English alphabet, dashes (-) and underscores (_); longer
660 callsigns are truncated, and characters not matching those
661 listed above are replaced with dashes.
662 --multiplay={in|out},hz,address,port
664 Specify the multiplayer communication settings.
665 The first field specifies whether the settings apply to inbound
667 (in) or outbound (out) communications. The second field (hz)
668 specifies the frequency (in Hz, times per second) at which data
669 should be sent. The third field (address) must be set to the IP
670 address of the network interface that FlightGear should use to
671 send/receive data, or left blank to let the simulator use all
672 available interfaces. The fourth field (port) should be set to
673 the port to use (usually 5000).
674 --proxy=[username:password@]host:port
676 Specify the proxy server and port to use. The username and pass‐
677 word are optional; if they are present, they should be given as
678 MD5 hashes.
679 This option is only useful if --real-weather-fetch is enabled.
681 --httpd=[address:]port
683 Enable the Phi interface (HTTP server) on the specified address
684 and port. The address is optional.
685 --telnet=port
687 Enable the Telnet interface on the specified port.
688 --jpg-httpd=port
690 Enable the screenshot HTTP server interface on the specified
691 port. This option is deprecated: use the Phi interface instead.
692 --enable-terrasync, --disable-terrasync
694 Enable/disable automatic scenery/object downloads.
695 --terrasync-dir=directory
697 Set the directory where the downloaded scenery will be stored to
698 directory.
699 --enable-fgcom, --disable-fgcom
701 Enable/disable the FGCom (voice ATC) integration.
702 I/O options
704 --generic=params, --atlas=params, --atcsim=params, --AV400=params,
705 --AV400Sim=params, --AV400WSimA=params, --AV400WSimB=params,
706 --garmin=params, --hla=params, --hla-local=params, --igc=params, --joy‐
707 client=params, --jsclient=params, --native-ctrls=params,
708 --native-gui=params, --native-fdm=params, --native=params,
709 --nmea=params, --opengc=params, --props=params, --pve=params,
710 --ray=params, --rul=params
711 Open a connection to drive external programs or hardware.
712 Specify the protocol by using the correct command-line option:
714 · generic: a predefined communication interface and a prese‐
716 lected communication protocol;
717 · atlas: the Atlas protocol;
719 · atcsim: the ATCsim (atc610x) protocol;
721 · AV400: the Garmin AV400 protocol, required to drive a Garmin
723 196/296 series GPS;
724 · AV400Sim: the set of AV400 strings required to drive a Garmin
726 400-series GPS;
727 · AV400WSimA, AV400WSimB: the set of strings required to drive
729 a Garmin WAAS GPS (where the A channel uses a variant of the
730 AVSim400 protocol and the B channel communicates with the GPS
731 unit);
732 · garmin: the Garmin GPS protocol;
734 · hla, hla-local: the HLA protocol, either remote or local;
736 · igc: the International Glider Commission protocol;
738 · joyclient: the protocol used by Agwagon joysticks;
740 · native-ctrls: the FlightGear Native Controls protocol;
742 · native-gui: the FlightGear Native GUI protocol;
744 · native-fdm: the FlightGear Native FDM protocol;
746 · native: the FlightGear Native protocol;
748 · nmea: the NMEA protocol (used to drive most GPS units);
750 · opengc: the protocol used by OpenGC, a software used to ren‐
752 der high-quality glass cockpit displays for simulated flight‐
753 decks;
754 · props: the interactive property manager protocol;
756 · pve: the PVE protocol;
758 · ray: the Ray Woodworth motion chair protocol;
760 · rul: the RUL protocol.
762 The parameters (params) must be in the form medium,direc‐
764 tion,hz,medium_options where medium is the medium used by the
765 protocol (serial, socket, file...), direction is the communica‐
766 tion direction (in, out or bi), hz is the frequency the channel
767 should be processed at (floating point values are accepted) and
768 medium_options are:
769 · for serial protocols, device,baud, where device is the device
772 name to be opened and baud is the communication baud rate;
773 · for socket protocols, machine,port,style, where machine is
775 the machine name or the IP address of the server (if the sim‐
776 ulator should act as a client) or is left empty (if the simu‐
777 lator should act as a server), port is the port to use (or is
778 left empty to ask the operating system to choose an available
779 port) and style is tcp or udp;
780 · for file protocols, filename, where filename is the name of
782 the file data should be written to.
783 Debugging options
785 --enable-fpe
786 Abort when a floating-point exception is encountered.
787 --fgviewer
789 View the scenery and the aircraft in a simple model viewer,
790 without loading the entire simulator.
791 --log-level=bulk|debug|info|warn|alert
793 Set the minimum logging level. Log messages having a severity
794 greater than or equal to the specified value are recorded; the
795 others are discarded.
796 --log-class=all|none|ai|environment|flight|general|io|net‐
798 work|sound|terrain|...
799 Log only events belonging to the specified log classes (all logs
800 all events, none logs none). Multiple classes can be specified
801 by separating them with commas or pipes, for example:
802 --log-class=ai,flight.
803 --log-dir=dir
805 Save the logs in the directory dir. If dir is desktop, the logs
806 are saved on the Desktop. This option may be given several
807 times, using a different directory each time. Inside the speci‐
808 fied directory, the log file will be named FlightGear_YYYY-MM-
809 DD_num.log, where YYYY-MM-DD is the current date and num is a
810 progressive number starting at 0.
811 --trace-read=property, --trace-write=property
813 Trace the reads/writes for a property (print a log message when‐
814 ever property is read from/written to).
815 --developer
817 Enable developer mode.
818
820 fgfs exits with 0 if the execution completes successfully, or with
821 another status (usually 1 or -1) if an error occurred.
822
824 COMPUTERNAME
825 Specifies the hostname of the system in use. This environment vari‐
826 able is only taken into account on Microsoft Windows operating sys‐
827 tems.
828 FG_AIRCRAFT
830 Specifies the path in which aircraft should be searched for.
831 FG_LAUNCHER
833 If this environment variable is set and is not 0, the Qt launcher
834 will be shown. The variable is mainly used on Mac OS X operating
835 systems to avoid the use of wrapper scripts.
836 FG_ROOT
838 Specifies the root data directory to use.
839 FG_SCENERY
841 Specifies the scenery directory to use.
842 HTTP_PROXY
844 Specifies the HTTP proxy to use. Must be in the form
845 http://host:port/.
846 LANG
848 Specifies the language to use.
849
851 ~/.fgfs
852 The main directory where FlightGear configuration files and data
853 (downloaded aircraft/scenery) are stored.
854 ~/.fgfsrc.hostname, ~/.fgfsrc
856 Configuration files containing command-line options for fgfs(1).
857FlightGear 2017-06-25 FGFS(1)