83 #define DISPLAY(...)           fprintf(stderr, __VA_ARGS__)  macro
84 #define DISPLAYLEVEL(l, ...)   do { if (displayLevel>=l) DISPLAY(__VA_ARGS__); } while (0)
94 #define DEBUGOUTPUT(...) do { if (DEBUG) DISPLAY(__VA_ARGS__); } while (0)
126     DISPLAY( "Usage : \n");  in usage()
127     DISPLAY( "      %s [arg] [input] [output] \n", exeName);  in usage()
128     DISPLAY( "\n");  in usage()
129     DISPLAY( "input   : a filename \n");  in usage()
130     DISPLAY( "          with no FILE, or when FILE is - or %s, read standard input\n", stdinmark);  in usage()
131     DISPLAY( "Arguments : \n");  in usage()
132     DISPLAY( " -1     : fast compression (default) \n");  in usage()
133     DISPLAY( " -%2d    : slowest compression level \n", LZ4HC_CLEVEL_MAX);  in usage()
134 …  DISPLAY( " -T#    : use # threads for compression (default:%i==auto) \n", LZ4_NBWORKERS_DEFAULT);  in usage()
135     DISPLAY( " -d     : decompression (default for %s extension)\n", LZ4_EXTENSION);  in usage()
136     DISPLAY( " -f     : overwrite output without prompting \n");  in usage()
137     DISPLAY( " -k     : preserve source files(s)  (default) \n");  in usage()
138     DISPLAY( "--rm    : remove source file(s) after successful de/compression \n");  in usage()
139     DISPLAY( " -h/-H  : display help/long help and exit \n");  in usage()
145     DISPLAY(WELCOME_MESSAGE);  in usage_advanced()
147     DISPLAY( "\n");  in usage_advanced()
148     DISPLAY( "Advanced arguments :\n");  in usage_advanced()
149     DISPLAY( " -V     : display Version number and exit \n");  in usage_advanced()
150     DISPLAY( " -v     : verbose mode \n");  in usage_advanced()
151     DISPLAY( " -q     : suppress warnings; specify twice to suppress errors too\n");  in usage_advanced()
152     DISPLAY( " -c     : force write to standard output, even if it is the console\n");  in usage_advanced()
153     DISPLAY( " -t     : test compressed file integrity\n");  in usage_advanced()
154     DISPLAY( " -m     : multiple input files (implies automatic output filenames)\n");  in usage_advanced()
156     DISPLAY( " -r     : operate recursively on directories (sets also -m) \n");  in usage_advanced()
158     DISPLAY( " -l     : compress using Legacy format (Linux kernel compression)\n");  in usage_advanced()
159     DISPLAY( " -z     : force compression \n");  in usage_advanced()
160     DISPLAY( " -D FILE: use FILE as dictionary (compression & decompression)\n");  in usage_advanced()
161     DISPLAY( " -B#    : cut file into blocks of size # bytes [32+] \n");  in usage_advanced()
162 …DISPLAY( "                     or predefined block size [4-7] (default: %i) \n", LZ4_BLOCKSIZEID_D…  in usage_advanced()
163     DISPLAY( " -BI    : Block Independence (default) \n");  in usage_advanced()
164     DISPLAY( " -BD    : Block dependency (improves compression ratio) \n");  in usage_advanced()
165     DISPLAY( " -BX    : enable block checksum (default:disabled) \n");  in usage_advanced()
166     DISPLAY( "--no-frame-crc : disable stream checksum (default:enabled) \n");  in usage_advanced()
167     DISPLAY( "--content-size : compressed frame includes original size (default:not present)\n");  in usage_advanced()
168 …DISPLAY( "--list FILE : lists information about .lz4 files (useful for files compressed with --con…  in usage_advanced()
169     DISPLAY( "--[no-]sparse  : sparse mode (default:enabled on file, disabled on stdout)\n");  in usage_advanced()
170     DISPLAY( "--favor-decSpeed: compressed files decompress faster, but are less compressed \n");  in usage_advanced()
171     DISPLAY( "--fast[=#]: switch to ultra fast compression level (default: %i)\n", 1);  in usage_advanced()
172     DISPLAY( "--best  : same as -%d\n", LZ4HC_CLEVEL_MAX);  in usage_advanced()
173     DISPLAY( "Benchmark arguments : \n");  in usage_advanced()
174     DISPLAY( " -b#    : benchmark file(s), using # compression level (default : 1) \n");  in usage_advanced()
175     DISPLAY( " -e#    : test all compression levels from -bX to # (default : 1)\n");  in usage_advanced()
176     DISPLAY( " -i#    : minimum evaluation time in seconds (default : 3s) \n");  in usage_advanced()
178         DISPLAY( "Legacy arguments : \n");  in usage_advanced()
179         DISPLAY( " -c0    : fast compression \n");  in usage_advanced()
180         DISPLAY( " -c1    : high compression \n");  in usage_advanced()
181         DISPLAY( " -c2,-hc: very high compression \n");  in usage_advanced()
182         DISPLAY( " -y     : overwrite output without prompting \n");  in usage_advanced()
190     DISPLAY( "\n");  in usage_longhelp()
191     DISPLAY( "****************************\n");  in usage_longhelp()
192     DISPLAY( "***** Advanced comment *****\n");  in usage_longhelp()
193     DISPLAY( "****************************\n");  in usage_longhelp()
194     DISPLAY( "\n");  in usage_longhelp()
195     DISPLAY( "Which values can [output] have ? \n");  in usage_longhelp()
196     DISPLAY( "---------------------------------\n");  in usage_longhelp()
197     DISPLAY( "[output] : a filename \n");  in usage_longhelp()
198     DISPLAY( "          '%s', or '-' for standard output (pipe mode)\n", stdoutmark);  in usage_longhelp()
199     DISPLAY( "          '%s' to discard output (test mode) \n", NULL_OUTPUT);  in usage_longhelp()
200     DISPLAY( "[output] can be left empty. In this case, it receives the following value :\n");  in usage_longhelp()
201     DISPLAY( "          - if stdout is not the console, then [output] = stdout \n");  in usage_longhelp()
202     DISPLAY( "          - if stdout is console : \n");  in usage_longhelp()
203     DISPLAY( "               + for compression, output to filename%s \n", LZ4_EXTENSION);  in usage_longhelp()
204 …  DISPLAY( "               + for decompression, output to filename without '%s'\n", LZ4_EXTENSION);  in usage_longhelp()
205 …DISPLAY( "                    > if input filename has no '%s' extension : error \n", LZ4_EXTENSION…  in usage_longhelp()
206     DISPLAY( "\n");  in usage_longhelp()
207     DISPLAY( "Compression levels : \n");  in usage_longhelp()
208     DISPLAY( "---------------------\n");  in usage_longhelp()
209     DISPLAY( "-0 ... -2  => Fast compression, all identical\n");  in usage_longhelp()
210 …DISPLAY( "-3 ... -%d => High compression; higher number == more compression but slower\n", LZ4HC_C…  in usage_longhelp()
211     DISPLAY( "\n");  in usage_longhelp()
212     DISPLAY( "stdin, stdout and the console : \n");  in usage_longhelp()
213     DISPLAY( "--------------------------------\n");  in usage_longhelp()
214     DISPLAY( "To protect the console from binary flooding (bad argument mistake)\n");  in usage_longhelp()
215     DISPLAY( "%s will refuse to read from console, or write to console \n", exeName);  in usage_longhelp()
216     DISPLAY( "except if '-c' command is specified, to force output to console \n");  in usage_longhelp()
217     DISPLAY( "\n");  in usage_longhelp()
218     DISPLAY( "Simple example :\n");  in usage_longhelp()
219     DISPLAY( "----------------\n");  in usage_longhelp()
220     DISPLAY( "1 : compress 'filename' fast, using default output name 'filename.lz4'\n");  in usage_longhelp()
221     DISPLAY( "          %s filename\n", exeName);  in usage_longhelp()
222     DISPLAY( "\n");  in usage_longhelp()
223     DISPLAY( "Short arguments can be aggregated. For example :\n");  in usage_longhelp()
224     DISPLAY( "----------------------------------\n");  in usage_longhelp()
225     DISPLAY( "2 : compress 'filename' in high compression mode, overwrite output if exists\n");  in usage_longhelp()
226     DISPLAY( "          %s -9 -f filename \n", exeName);  in usage_longhelp()
227     DISPLAY( "    is equivalent to :\n");  in usage_longhelp()
228     DISPLAY( "          %s -9f filename \n", exeName);  in usage_longhelp()
229     DISPLAY( "\n");  in usage_longhelp()
230     DISPLAY( "%s can be used in 'pure pipe mode'. For example :\n", exeName);  in usage_longhelp()
231     DISPLAY( "-------------------------------------\n");  in usage_longhelp()
232     DISPLAY( "3 : compress data stream from 'generator', send result to 'consumer'\n");  in usage_longhelp()
233     DISPLAY( "          generator | %s | consumer \n", exeName);  in usage_longhelp()
235         DISPLAY( "\n");  in usage_longhelp()
236         DISPLAY( "***** Warning  ***** \n");  in usage_longhelp()
237         DISPLAY( "Legacy arguments take precedence. Therefore : \n");  in usage_longhelp()
238         DISPLAY( "--------------------------------- \n");  in usage_longhelp()
239         DISPLAY( "          %s -hc filename \n", exeName);  in usage_longhelp()
240         DISPLAY( "means 'compress filename in high compression mode' \n");  in usage_longhelp()
241         DISPLAY( "It is not equivalent to : \n");  in usage_longhelp()
242         DISPLAY( "          %s -h -c filename \n", exeName);  in usage_longhelp()
243         DISPLAY( "which displays help text and exits \n");  in usage_longhelp()
258     DISPLAY("Press enter to continue...\n");  in waitEnter()
420         DISPLAY("Allocation error : not enough memory \n");  in main()