1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
|
<?xml version="1.0" encoding="UTF-8"?>
<!--
* This file is part of the LibreOffice project.
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*
* This file incorporates work covered by the following license notice:
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed
* with this work for additional information regarding copyright
* ownership. The ASF licenses this file to you under the Apache
* License, Version 2.0 (the "License"); you may not use this file
* except in compliance with the License. You may obtain a copy of
* the License at http://www.apache.org/licenses/LICENSE-2.0 .
-->
<helpdocument version="1.0">
<meta>
<topic id="textsharedguidestart_parametersxml" indexer="include" status="PUBLISH">
<title id="tit" xml-lang="en-US">Starting $[officename] Software With Parameters</title>
<filename>/text/shared/guide/start_parameters.xhp</filename>
</topic>
</meta>
<body>
<section id="start_parameters">
<bookmark xml-lang="en-US" branch="index" id="bm_id3156410">
<bookmark_value>start parameters</bookmark_value>
<bookmark_value>command line parameters</bookmark_value>
<bookmark_value>parameters;command line</bookmark_value>
<bookmark_value>arguments in command line</bookmark_value>
</bookmark>
<h1 id="hd_id3156410"><variable id="Title_h1"><link href="text/shared/guide/start_parameters.xhp">Starting $[officename] Software With Parameters</link></variable></h1>
<paragraph role="paragraph" id="par_id3147009" xml-lang="en-US">By starting $[officename] software from the command line you can assign various parameters, with which you can influence the performance. The use of command line parameters is only recommended for experienced users.</paragraph>
<note id="par_id3147618">For normal handling, the use of command line parameters is not necessary. A few of the parameters require a deeper knowledge of the technical background of $[officename] software technology.</note>
<h2 id="hd_id3154898">Starting $[officename] Software From the Command Line</h2>
<switch select="sys">
<case select="WIN">
<list type="ordered">
<listitem>
<paragraph role="listitem" id="par_id3156152" xml-lang="en-US">Search for <emph>Run</emph> in the Windows Start menu.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3152472" xml-lang="en-US">Type the following text in the <emph>Open</emph> text field and click <emph>OK</emph>. </paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3147561" xml-lang="en-US">"{install}\program\soffice.com" {parameter}</paragraph>
<paragraph role="listitem" id="par_id3153360" xml-lang="en-US">Replace <emph>{install}</emph> with the path to your installation of %PRODUCTNAME software (for example, <emph>C:\Program Files\%PRODUCTNAME</emph>). Use <emph>soffice.exe</emph> instead of <emph>soffice.com</emph>, when you do not need console (e.g., you do not use command-line interface for headless operations).</paragraph>
</listitem>
</list>
</case>
<default>
<list type="ordered">
<listitem>
<paragraph role="listitem" id="par_id3157152" xml-lang="en-US">Open a shell under Linux, *BSD, or macOS platforms.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3147669" xml-lang="en-US">Type the following line of text, then press <emph>Return</emph>:</paragraph>
<paragraph role="listitem" id="par_id3143561" xml-lang="en-US">{install}/program/soffice {parameter}</paragraph>
<paragraph role="listitem" id="par_id3157360" xml-lang="en-US">Replace <emph>{install}</emph> with the path to your installation of %PRODUCTNAME software (for example, <emph>/opt/%PRODUCTNAME</emph> in UNIX)</paragraph>
</listitem>
</list>
</default>
</switch>
<paragraph role="paragraph" id="par_id3147010" xml-lang="en-US">$[officename] requires write access to its user profile directory.</paragraph>
<h2 id="hd_id3145171">Valid Command Line Parameters</h2>
<h3 id="hd_id1016120408556191">Using without special arguments</h3>
<paragraph role="paragraph" id="par_id215247284938" xml-lang="en-US">Using without any arguments opens the start center.</paragraph>
<table id="tbl_id2016120408556132">
<tablerow>
<tablecell>
<paragraph id="par_id4016121206183262" role="tablecontent" xml-lang="en-US"><emph>{file}</emph></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id40161212062813818" role="tablecontent" xml-lang="en-US">Tries to open the file (files) in the components suitable for them.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id40161212063110720" role="tablecontent" xml-lang="en-US"><emph>{file} macro://./[Library.Module.MacroName]</emph></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id40161212063330252" role="tablecontent" xml-lang="en-US">Opens the file and applies specified macros from the file.</paragraph>
</tablecell>
</tablerow>
</table>
<h3 id="hd_id201612040855610">Getting help and information</h3>
<table id="tbl_id20161204085561">
<tablerow>
<tablecell>
<paragraph role="tablehead" id="par_id3148451" xml-lang="en-US"><variable id="parameter">Parameter</variable></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablehead" id="par_id3149167" xml-lang="en-US"><variable id="meaning">Meaning</variable></paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3149983" localize="false" xml-lang="en-US"><emph>--help / -h / -?</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3147349" xml-lang="en-US">Lists the available command line parameters to the console.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id2016120408595932" role="tablecontent" localize="false" xml-lang="en-US"><emph>--helpwriter</emph></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id20161204091221764" role="tablecontent" xml-lang="en-US">Opens $[officename] built-in or online Help on Writer.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id20161204091430073" role="tablecontent" localize="false" xml-lang="en-US"><emph>--helpcalc</emph></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id20161204091520522" role="tablecontent" xml-lang="en-US">Opens $[officename] built-in or online Help on Calc.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id20161204091613165" role="tablecontent" localize="false" xml-lang="en-US"><emph>--helpdraw</emph></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id20161204091727059" role="tablecontent" xml-lang="en-US">Opens $[officename] built-in or online Help on Draw.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id2016120409175485" role="tablecontent" localize="false" xml-lang="en-US"><emph>--helpimpress</emph></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id20161204091812159" role="tablecontent" xml-lang="en-US">Opens $[officename] built-in or online Help on Impress.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id2016120409189173" role="tablecontent" localize="false" xml-lang="en-US"><emph>--helpbase</emph></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id20161204091919599" role="tablecontent" xml-lang="en-US">Opens $[officename] built-in or online Help on Base.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id20161204092016613" role="tablecontent" localize="false" xml-lang="en-US"><emph>--helpbasic</emph></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id20161204092029619" role="tablecontent" xml-lang="en-US">Opens $[officename] built-in or online Help on Basic scripting language.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id20161204092113738" role="tablecontent" localize="false" xml-lang="en-US"><emph>--helpmath</emph></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id2016120409214276" role="tablecontent" xml-lang="en-US">Opens $[officename] built-in or online Help on Math.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id31499et" localize="false" xml-lang="en-US"><emph>--version</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id31473et" xml-lang="en-US">Shows $[officename] version and quits.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id2016120409226160" role="tablecontent" localize="false" xml-lang="en-US"><emph>--nstemporarydirectory</emph></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id2016120409236546" role="tablecontent" xml-lang="en-US">(macOS sandbox only) Returns path of the temporary directory for the current user and exits. Overrides all other arguments.</paragraph>
</tablecell>
</tablerow>
</table>
<h3 id="hd_id20161204094429235">General arguments</h3>
<table id="tbl_id201612040855">
<tablerow>
<tablecell>
<paragraph id="par_id20161204095215085" role="tablehead" localize="false" xml-lang="en-US"><embedvar href="text/shared/guide/start_parameters.xhp#parameter"/></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id201612040953917" role="tablehead" localize="false" xml-lang="en-US"><embedvar href="text/shared/guide/start_parameters.xhp#meaning"/></paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3148477" localize="false" xml-lang="en-US"><emph>--quickstart[=no]</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3153919" xml-lang="en-US">Activates[Deactivates] the Quickstarter service. It can take only one parameter <emph>no</emph> which deactivates the Quickstarter service. Without parameters this service is activated.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id315917t" localize="false" xml-lang="en-US"><emph>--nolockcheck</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id315330t" xml-lang="en-US">Disables check for remote instances using the installation.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id314959o" localize="false" xml-lang="en-US"><emph>--infilter=InputFilterName</emph><br/><emph>[:InputFilterParam[,param]]</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id315053o" xml-lang="en-US">Forces an input filter type, if possible. For example:</paragraph>
<paragraph role="tablecontent" id="par_id411550934641187" localize="false"><input>--infilter="Calc Office Open XML"</input></paragraph>
<paragraph role="tablecontent" id="par_id501550934647297" localize="false"><input>--infilter="Text (encoded):UTF8,LF,Liberation Mono,en-US"</input>.</paragraph>
<embed href="text/shared/guide/start_parameters.xhp#seefilters"/>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id2016120409546167" role="tablecontent" localize="false" xml-lang="en-US"><emph>--pidfile={file}</emph></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id20161204101917197" role="tablecontent" xml-lang="en-US">Store soffice.bin pid to <emph>{file}</emph>.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3153915" localize="false" xml-lang="en-US"><emph>--display {display}</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3146786" xml-lang="en-US">Sets the <emph>DISPLAY</emph> environment variable on UNIX-like platforms to the value <emph>{display}</emph>. This parameter is only supported by the start script for $[officename] software on UNIX-like platforms.</paragraph>
</tablecell>
</tablerow>
</table>
<h3 id="hd_id20161204103115358">User/programmatic interface control</h3>
<table id="tbl_id20170517001">
<tablerow>
<tablecell>
<paragraph id="par_id20161204095214085" role="tablehead" localize="false" xml-lang="en-US"><embedvar href="text/shared/guide/start_parameters.xhp#parameter"/></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id201612040943917" role="tablehead" localize="false" xml-lang="en-US"><embedvar href="text/shared/guide/start_parameters.xhp#meaning"/></paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3155126" localize="false" xml-lang="en-US"><emph>--nologo</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3151334" xml-lang="en-US">Disables the splash screen at program start.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3156276" localize="false" xml-lang="en-US"><emph>--minimized</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3146080" xml-lang="en-US">Starts minimized. The splash screen is not displayed.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3159171" localize="false" xml-lang="en-US"><emph>--nodefault</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3153306" xml-lang="en-US">Starts without displaying anything except the splash screen.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3145641" localize="false" xml-lang="en-US"><emph>--invisible</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3154756" xml-lang="en-US">Starts in invisible mode.</paragraph>
<paragraph role="tablecontent" id="par_id3148914" xml-lang="en-US">Neither the start-up logo nor the initial program window will be visible. $[officename] software can be controlled, and documents and dialogs can be controlled and opened via the <link href="https://api.libreoffice.org">API</link>.</paragraph>
<paragraph role="tablecontent" id="par_id3147341" xml-lang="en-US">Using the parameter, $[officename] can only be ended using the taskmanager (Windows) or the <emph>kill </emph>command (UNIX-like systems).</paragraph>
<paragraph role="tablecontent" id="par_id3150388" xml-lang="en-US">It cannot be used in conjunction with <emph>--quickstart</emph>.</paragraph>
<paragraph role="tablecontent" id="par_id3145147" xml-lang="en-US">More information is found in <emph>$[officename] Developer's Guide</emph>.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3149595" localize="false" xml-lang="en-US"><emph>--headless</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3150530" xml-lang="en-US">Starts in "headless mode" which allows using the application without user interface.</paragraph>
<paragraph role="tablecontent" id="par_id3156353" xml-lang="en-US">This special mode can be used when the application is controlled by external clients via the <link href="https://api.libreoffice.org">API</link>.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3155903" localize="false" xml-lang="en-US"><emph>--norestore</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3156374" xml-lang="en-US">Disables restart and file recovery after a system crash.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id20161204120031515" role="tablecontent" localize="false" xml-lang="en-US"><emph>--safe-mode</emph></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id20161204120122917" role="tablecontent" xml-lang="en-US">Starts in a safe mode, i.e. starts temporarily with a fresh user profile and helps to restore a broken configuration.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3152479" localize="false" xml-lang="en-US"><emph>--accept={UNO}</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3147130" xml-lang="en-US">Notifies $[officename] software that upon the creation of "UNO Acceptor Threads", a "UNO Accept String" will be used.</paragraph>
<paragraph id="par_id20161204120828147" role="tablecontent" xml-lang="en-US">UNO-URL is string the such kind <emph>uno:connection-type,params;protocol-name,params;ObjectName</emph>.</paragraph>
<paragraph role="tablecontent" id="par_id3148874" xml-lang="en-US">More information is found in <emph>$[officename] Developer's Guide</emph>.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id315247a" localize="false" xml-lang="en-US"><emph>--unaccept={UNO-URL}</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id314713a" xml-lang="en-US">Closes an acceptor that was created with <emph>--accept={UNO-URL}</emph>. Use <emph>--unaccept=all</emph> to close all open acceptors.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id20161204121324766" role="tablecontent" localize="false" xml-lang="en-US"><emph>--language={lang}</emph></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id20161204121422689" role="tablecontent" xml-lang="en-US">Uses specified language, if language is not selected yet for UI. The lang is a tag of the language in IETF language tag.</paragraph>
</tablecell>
</tablerow>
</table>
<h3 id="par_id201612041220386">Developer arguments</h3>
<table id="tbl_id20170517002">
<tablerow>
<tablecell>
<paragraph id="par_id20161304095215085" role="tablehead" localize="false" xml-lang="en-US"><embedvar href="text/shared/guide/start_parameters.xhp#parameter"/></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id201612030953917" role="tablehead" localize="false" xml-lang="en-US"><embedvar href="text/shared/guide/start_parameters.xhp#meaning"/></paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id2016120412214434" role="tablecontent" localize="false" xml-lang="en-US"><emph>--terminate_after_init</emph></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id20161204122216505" role="tablecontent" xml-lang="en-US">Exit after initialization complete (no documents loaded).</paragraph>
</tablecell>
</tablerow>
</table>
<switch select="sys">
<case select="UNIX">
<paragraph role="paragraph" id="par_id631571706947129">Unix and Linux user can invoke %PRODUCTNAME with these additional parameters for debugging purposes.</paragraph>
<table id="tab_id371571706970240">
<tablerow>
<tablecell>
<paragraph id="par_id491571706970241" role="tablehead">Parameter</paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id11571706970242" role="tablehead">Meaning</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id51571706970244" localize="false" role="paragraph"><emph>--record</emph></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id11571706970245" role="paragraph">An enhanced debugger.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id751571707080685" localize="false" role="paragraph"><emph>--backtrace</emph></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id971571707080686" role="paragraph">Prints the backtrace of the entire stack.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id171571707097883" localize="false" role="paragraph"><emph>--strace</emph></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id621571707097884" role="paragraph">strace is a diagnostic, debugging and instructional userspace utility for Linux.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id81571707115501" localize="false" role="paragraph"><emph>--valgrind</emph></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id281571707115502" role="paragraph">Automatically detect many memory management and threading bugs, and profile the program in detail.</paragraph>
</tablecell>
</tablerow>
</table>
<note id="par_id571571707462064">The debug options <emph>--record</emph>, <emph>--backtrace</emph>, <emph>--strace</emph> and <emph>--valgrind</emph> cannot be used together. Please use them one by one.</note>
</case>
<default/>
</switch>
<h3 id="par_id20161204122420839">New document creation arguments</h3>
<note id="par_id20161204122414892">The arguments create an empty document of specified kind. Only one of them may be used in one command line. If filenames are specified after an argument, then it tries to open those files in the specified component.</note>
<table id="tbl_id20170517003">
<tablerow>
<tablecell>
<paragraph id="par_id20101204095215085" role="tablehead" localize="false" xml-lang="en-US"><embedvar href="text/shared/guide/start_parameters.xhp#parameter"/></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id201612040953987" role="tablehead" localize="false" xml-lang="en-US"><embedvar href="text/shared/guide/start_parameters.xhp#meaning"/></paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3150010" localize="false" xml-lang="en-US"><emph>--writer</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3147213" xml-lang="en-US">Starts with an empty Writer document.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3148616" localize="false" xml-lang="en-US"><emph>--calc</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3145261" xml-lang="en-US">Starts with an empty Calc document.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3156443" localize="false" xml-lang="en-US"><emph>--draw</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3154011" xml-lang="en-US">Starts with an empty Draw document.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3153142" localize="false" xml-lang="en-US"><emph>--impress</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3153222" xml-lang="en-US">Starts with an empty Impress document.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3155853" localize="false" xml-lang="en-US"><emph>--math</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3146928" xml-lang="en-US">Starts with an empty Math document.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3149960" localize="false" xml-lang="en-US"><emph>--global</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3151075" xml-lang="en-US">Starts with an empty Writer master document.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3154510" localize="false" xml-lang="en-US"><emph>--web</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3148836" xml-lang="en-US">Starts with an empty HTML document.</paragraph>
</tablecell>
</tablerow>
</table>
<h3 id="par_id20161204125123476">File open arguments</h3>
<note id="par_id20161204125411030">The arguments define how following filenames are treated. New treatment begins after the argument and ends at the next argument. The default treatment is to open documents for editing, and create new documents from document templates.</note>
<table id="tbl_id20170517004">
<tablerow>
<tablecell>
<paragraph id="par_id20161204795215085" role="tablehead" localize="false" xml-lang="en-US"><embedvar href="text/shared/guide/start_parameters.xhp#parameter"/></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id201612040955917" role="tablehead" localize="false" xml-lang="en-US"><embedvar href="text/shared/guide/start_parameters.xhp#meaning"/></paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3166421" localize="false" xml-lang="en-US"><emph>-n</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3154259" xml-lang="en-US">Treats following files as templates for creation of new documents.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3154372" localize="false" xml-lang="en-US"><emph>-o</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3150309" xml-lang="en-US">Opens following files for editing, regardless whether they are templates or not.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3150883" localize="false" xml-lang="en-US"><emph>--pt {Printername}</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3155081" xml-lang="en-US">Prints the following files to the printer <emph>{Printername}</emph> and ends. The splash screen does not appear.</paragraph>
<paragraph role="tablecontent" id="par_id3153655" xml-lang="en-US">If the file name contains spaces, then it must be enclosed in quotation marks.</paragraph>
<paragraph id="par_id20161204010513716" role="tablecontent" xml-lang="en-US">If used multiple times, only last <emph>{Printername}</emph> is effective for all documents of all <emph>--pt</emph> runs.</paragraph>
<paragraph id="par_id2016120401061890" role="tablecontent" xml-lang="en-US">Also, <emph>--printer-name</emph> argument of <emph>--print-to-file</emph> switch interferes with <emph>{Printername}</emph>.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3159238" localize="false" xml-lang="en-US"><emph>-p</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3163666" xml-lang="en-US">Prints following files to the default printer, after which those files are closed. The splash screen does not appear.</paragraph>
<paragraph role="tablecontent" id="par_id3150828" xml-lang="en-US">If the file name contains spaces, then it must be enclosed in quotation marks.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3151182" localize="false" xml-lang="en-US"><emph>--view</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3145268" xml-lang="en-US">Opens following files in viewer mode (read-only).</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3149403" xml-lang="en-US"><emph>--show[=N]</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3153838" xml-lang="en-US">Opens and starts the slideshow of the following presentation documents immediately. Files are closed after the showing. <literal>N</literal> in the example refers to the slide number and, when it is provided, they start at that slide.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id314959p" localize="false" xml-lang="en-US"><emph>--convert-to OutputFileExtension</emph><br/><emph>[:OutputFilterName</emph><br/><emph>[:OutputFilterParams[,param]]]</emph><br/><emph> [--outdir output_dir]</emph></paragraph>
</tablecell>
<tablecell>
<section id="convertto">
<paragraph id="par_id2016120401222926" role="tablecontent" xml-lang="en-US">If <emph>--convert-to</emph> is used more than once, last value of <emph>OutputFileExtension[:OutputFilterName[:OutputFilterParams]]</emph> is effective. If <emph>--outdir</emph> is used more than once, only its last value is effective. In absence of <emph>--outdir</emph>, current working directory is used for the result. For example:</paragraph>
<paragraph id="par_id20161204012319752" role="tablecontent" localize="false" xml-lang="en-US"><input>--convert-to pdf *.doc</input></paragraph>
<paragraph role="tablecontent" id="par_id311550932952863" localize="false"><input>--convert-to pdf:writer_pdf_Export --outdir /home/user *.doc</input></paragraph>
<paragraph role="tablecontent" id="par_id231550932985601" localize="false"><input>--convert-to "html:XHTML Writer File:UTF8" *.doc</input></paragraph>
<paragraph role="tablecontent" id="par_id211550932999288" localize="false"><input>--convert-to "txt:Text (encoded):UTF8" *.doc</input></paragraph>
</section>
<section id="seefilters">
<paragraph role="tablecontent" id="par_id781554408625219">See the <link href="text/shared/guide/convertfilters.xhp">list of document filters</link> for file conversion.</paragraph>
<paragraph role="paragraph" id="par_id51634741869672">The list of <link href="text/shared/guide/lotusdbasediff.xhp">filter options for Lotus, dBase and Diff files</link>.</paragraph>
<paragraph role="paragraph" id="par_id1001634741874640">The list of <link href="text/shared/guide/csv_params.xhp">filter options for CSV files</link>.</paragraph>
<paragraph role="paragraph" id="par_id611682112346540">The list of <link href="text/shared/guide/pdf_params.xhp">filter options for PDF files</link>.</paragraph>
</section>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id314959q" localize="false" xml-lang="en-US"><emph>--print-to-file [--printer-name printer_name] [--outdir output_dir]</emph></paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id315053q" xml-lang="en-US">Batch print files to file. If <emph>--outdir</emph> is not specified, then current working directory is used as output_dir.</paragraph>
<paragraph id="par_id20161204012928262" role="tablecontent" xml-lang="en-US">If <emph>--printer-name</emph> or <emph>--outdir</emph> used multiple times, only last value of each is effective. Also, <emph>{Printername}</emph> of <emph>--pt</emph> switch interferes with <emph>--printer-name</emph>. For example:</paragraph>
<paragraph id="par_id201612040131763" role="tablecontent" localize="false" xml-lang="en-US"><input>--print-to-file *.doc</input></paragraph>
<paragraph role="tablecontent" id="par_id421550933601790" localize="false"><input>--print-to-file --printer-name nasty_lowres_printer --outdir /home/user *.doc</input></paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id20161204013415783" role="tablecontent" localize="false" xml-lang="en-US"><emph>--cat</emph></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id2016120401348732" role="tablecontent" xml-lang="en-US">Applies filter "txt:Text" to the following text documents and dump text content to console (implies <emph>--headless</emph>). Cannot be used with <emph>--convert-to</emph>.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id201612040137850" role="tablecontent" localize="false" xml-lang="en-US"><emph>-env:VAR[=VALUE]</emph></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id2016120401398657" role="tablecontent" xml-lang="en-US">Set a bootstrap variable. For example, to set a non-default user profile path:</paragraph>
<paragraph id="par_id20161204013922181" role="tablecontent" localize="false" xml-lang="en-US">
<switchinline select="sys">
<caseinline select="WIN"><input>soffice.com -env:UserInstallation=file:///c:/my-test-profile</input> </caseinline>
<caseinline select="MAC"><input>open LibreOffice.app -env:UserInstallation=file:///tmp/test</input> </caseinline>
<defaultinline><input>soffice -env:UserInstallation=file:///tmp/test</input></defaultinline>
</switchinline>
</paragraph>
</tablecell>
</tablerow>
</table>
<h3 id="par_id20161204014126760">Ignored switches</h3>
<table id="tbl_id20170517005">
<tablerow>
<tablecell>
<paragraph id="par_id20161200095215085" role="tablehead" localize="false" xml-lang="en-US"><embedvar href="text/shared/guide/start_parameters.xhp#parameter"/></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id201312040953917" role="tablehead" localize="false" xml-lang="en-US"><embedvar href="text/shared/guide/start_parameters.xhp#meaning"/></paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id2016120401411383" role="tablecontent" localize="false" xml-lang="en-US"><emph>-psn</emph></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id2016120401435616" role="tablecontent" xml-lang="en-US">Ignored (macOS only)</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id20161204014316430" role="tablecontent" localize="false" xml-lang="en-US"><emph>-Embedding </emph></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id20161204014423695" role="tablecontent" xml-lang="en-US">Ignored (COM+ related; Windows only)</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id20161204014422700" role="tablecontent" localize="false" xml-lang="en-US"><emph>--nofirststartwizard</emph></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id20161204014529900" role="tablecontent" xml-lang="en-US">Does nothing, accepted only for backward compatibility.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id20161204014532015" role="tablecontent" localize="false" xml-lang="en-US"><emph>--protector {arg1} {arg2}</emph></paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id2016120401463584" role="tablecontent" xml-lang="en-US">Used only in unit tests and should have two arguments.</paragraph>
</tablecell>
</tablerow>
</table>
</section>
</body>
</helpdocument>
|
