xref: /freebsd/usr.bin/fortune/datfiles/freebsd-tips (revision 349cc55c9796c4596a5b9904cd3281af295f878f)
1Any user that is a member of the wheel group can use "su -" to simulate
2a root login. You can add a user to the wheel group by editing /etc/group.
3		-- Konstantinos Konstantinidis <kkonstan@duth.gr>
4%
5By pressing "Scroll Lock" you can use the arrow keys to scroll backward
6through the console output.  Press "Scroll Lock" again to turn it off.
7Don't have a "Scroll Lock" key? The "Pause / Break" key acts alike.
8%
9Can't remember if you've installed a certain port or not? Try "pkg info
10-x port_name".
11%
12Ever wonder what those numbers after command names were, as in cat(1)?  It's
13the section of the manual the man page is in.  "man man" will tell you more.
14		-- David Scheidt <dscheidt@tumbolia.com>
15%
16Forget how to spell a word or a variation of a word? Use
17
18	look portion_of_word_you_know
19		-- Dru <genesis@istar.ca>
20%
21Forget what directory you are in? Type "pwd".
22		-- Dru <genesis@istar.ca>
23%
24Forget when Easter is? Try "ncal -e". If you need the date for Orthodox
25Easter, use "ncal -o" instead.
26		-- Dru <genesis@istar.ca>
27%
28FreeBSD is started up by the program 'init'.  The first thing init does when
29starting multiuser mode (ie, starting the computer up for normal use) is to
30run the shell script /etc/rc.  By reading /etc/rc and the /etc/rc.d/ scripts,
31you can learn a lot about how the system is put together, which again will
32make you more confident about what happens when you do something with it.
33%
34Handy bash(1) prompt:  PS1="\u@\h \w \!$ "
35		-- David Scheidt <dscheidt@tumbolia.com>
36%
37Having trouble using fetch through a firewall? Try setting the environment
38variable FTP_PASSIVE_MODE to yes, and see fetch(3) for more details.
39%
40If other operating systems have damaged your Master Boot Record, you can
41reinstall it with gpart(8). See
42"man gpart" for details.
43%
44If you accidentally end up inside vi, you can quit it by pressing Escape, colon
45(:), q (q), bang (!) and pressing return.
46%
47If you do not want to get beeps in X11 (X Windows), you can turn them off with
48
49	xset b off
50%
51If you have a CD-ROM drive in your machine, you can make the CD-ROM that is
52presently inserted available by typing 'mount /cdrom' as root.  The CD-ROM
53will be available under /cdrom/.  Remember to do 'umount /cdrom' before
54removing the CD-ROM (it will usually not be possible to remove the CD-ROM
55without doing this.)
56
57Note: This tip may not work in all configurations.
58%
59If you need a reminder to leave your terminal, type "leave +hhmm" where
60"hhmm" represents in how many hours and minutes you need to leave.
61		-- Dru <genesis@istar.ca>
62%
63If you need to ask a question on the FreeBSD-questions mailing list then
64
65	https://docs.freebsd.org/en/articles/freebsd-questions
66
67contains lots of useful advice to help you get the best results.
68%
69If you write part of a filename in tcsh,
70pressing TAB will show you the available choices when there
71is more than one, or complete the filename if there's only one match.
72%
73If you `set watch = (0 any any)' in tcsh, you will be notified when
74someone logs in or out of your system.
75%
76If you use the C shell, add the following line to the .cshrc file in your
77home directory to prevent core files from being written to disk:
78
79	limit coredumpsize 0
80		-- Dru <genesis@istar.ca>
81%
82If you want df(1) and other commands to display disk sizes in
83kilobytes instead of 512-byte blocks, set BLOCKSIZE in your
84environment to 'K'.  You can also use 'M' for Megabytes or 'G' for
85Gigabytes.  If you want df(1) to automatically select the best size
86then use 'df -h'.
87%
88If you want to play CDs with FreeBSD, a utility for this is already included.
89Type 'cdcontrol' then 'help' to learn more.  (You may need to set the CDROM
90environment variable in order to make cdcontrol want to start.)
91%
92If you'd like to keep track of applications in the FreeBSD ports tree, take a
93look at FreshPorts;
94
95	https://www.freshports.org/
96%
97In order to make fetch (the FreeBSD downloading tool) ask for
98username/password when it encounters a password-protected web page, you can set
99the environment variable HTTP_AUTH to 'basic:*'.
100%
101In order to search for a string in some files, use 'grep' like this:
102
103	 grep "string" filename1 [filename2 filename3 ...]
104
105This will print out the lines in the files that contain the string.  grep can
106also do a lot more advanced searches - type 'man grep' for details.
107%
108In order to support national characters for European languages in tools like
109less without creating other nationalisation aspects, set the environment
110variable LC_ALL to 'en_US.UTF-8'.
111%
112"man firewall" will give advice for building a FreeBSD firewall using ipfw(8).
113		-- David Scheidt <dscheidt@tumbolia.com>
114%
115"man hier" will explain the way FreeBSD filesystems are normally laid out.
116		-- David Scheidt <dscheidt@tumbolia.com>
117%
118Man pages are divided into section depending on topic.  There are 9 different
119sections numbered from 1 (General Commands) to 9 (Kernel Developer's Manual).
120You can get an introduction to each topic by typing
121
122	man <number> intro
123
124In other words, to get the intro to general commands, type
125
126	man 1 intro
127%
128"man ports" gives many useful hints about installing FreeBSD ports.
129%
130"man security" gives very good advice on how to tune the security of your
131FreeBSD system.
132%
133"man tuning" gives some tips how to tune performance of your FreeBSD system.
134		-- David Scheidt <dscheidt@tumbolia.com>
135%
136Need to do a search in a manpage or in a file you've sent to a pager? Use
137"/search_word". To repeat the same search, type "n" for next or "p" for
138previous.
139		-- Dru <genesis@istar.ca>
140%
141Need to find the location of a program? Use "locate program_name".
142		-- Dru <genesis@istar.ca>
143%
144Need to leave your terminal for a few minutes and don't want to logout?
145Use "lock -p". When you return, use your password as the key to unlock the
146terminal.
147		-- Dru <genesis@istar.ca>
148%
149Need to quickly empty a file? Use ": > filename".
150		-- Dru <genesis@istar.ca>
151%
152Need to quickly return to your home directory? Type "cd".
153		-- Dru <genesis@istar.ca>
154%
155Need to remove all those ^M characters from a DOS file? Try
156
157	tr -d \\r < dosfile > newfile
158		-- Originally by Dru <genesis@istar.ca>
159%
160Need to see the calendar for this month? Simply type "cal".  To see the
161whole year, type "cal -y".
162		-- Dru <genesis@istar.ca>
163%
164Need to see which daemons are listening for connection requests? Use
165"sockstat -4l" for IPv4, and "sockstat -l" for IPv4 and IPv6.
166		-- Dru <genesis@istar.ca>
167%
168Need to see your routing table? Type "netstat -rn". The entry with the G
169flag is your gateway.
170		-- Dru <genesis@istar.ca>
171%
172Nice bash prompt: PS1='(\[$(tput md)\]\t <\w>\[$(tput me)\]) $(echo $?) \$ '
173		-- Mathieu <mathieu@hal.interactionvirtuelle.com>
174%
175Over quota?  "du -sh * | sort -h " will give you a sorted list of your
176directory sizes.
177		-- David Scheidt <dscheidt@tumbolia.com>
178%
179nc(1) (or netcat) is useful not only for redirecting input/output to
180TCP or UDP connections, but also for proxying them with inetd(8).
181%
182sh (the default Bourne shell in FreeBSD) supports command-line editing.  Just
183``set -o emacs'' or ``set -o vi'' to enable it. Use "<TAB>" key to complete
184paths.
185%
186Simple tcsh prompt: set prompt = '%# '
187%
188The default editor in FreeBSD is vi, which is efficient to use when you have
189learned it, but somewhat user-unfriendly.  To use ee (an easier but less
190powerful editor) instead, set the environment variable EDITOR to /usr/bin/ee
191%
192Time to change your password? Type "passwd" and follow the prompts.
193		-- Dru <genesis@istar.ca>
194%
195To change an environment variable in /bin/sh use:
196
197	$ VARIABLE="value"
198	$ export VARIABLE
199%
200To change an environment variable in tcsh you use: setenv NAME "value"
201where NAME is the name of the variable and "value" its new value.
202%
203To clear the screen, use "clear". To re-display your screen buffer, press
204the scroll lock key and use your page up button. When you're finished,
205press the scroll lock key again to get your prompt back.
206		-- Dru <genesis@istar.ca>
207%
208You can press Ctrl-L while in the shell to clear the screen.
209%
210To determine whether a file is a text file, executable, or some other type
211of file, use
212
213	file filename
214		-- Dru <genesis@istar.ca>
215%
216To do a fast search for a file, try
217
218	 locate filename
219
220locate uses a database that is updated every Saturday (assuming your computer
221is running FreeBSD at the time) to quickly find files based on name only.
222%
223To erase a line you've written at the command prompt, use "Ctrl-U".
224		-- Dru <genesis@istar.ca>
225%
226To find out the hostname associated with an IP address, use
227
228	drill -x IP_address
229		-- Dru <genesis@istar.ca>
230%
231To obtain a neat PostScript rendering of a manual page, use ``-t'' switch
232of the man(1) utility: ``man -t <topic>''.  For example:
233
234	man -t grep > grep.ps	# Save the PostScript version to a file
235or
236	man -t printf | lp	# Send the PostScript directly to printer
237%
238To quickly create an empty file, use "touch filename".
239		-- Dru <genesis@istar.ca>
240%
241To read a compressed file without having to first uncompress it, use
242"zcat" or "zless" to view it. There is also "bzcat", "bzless", "xzcat"
243and "xzless".
244		-- Dru <genesis@istar.ca>
245%
246To save disk space in your home directory, compress files you rarely
247use with "gzip filename".
248		-- Dru <genesis@istar.ca>
249%
250To search for files that match a particular name, use find(1); for example
251
252	find / -name "*GENERIC*" -ls
253
254will search '/', and all subdirectories, for files with 'GENERIC' in the name.
255      	--  Stephen Hilton <nospam@hiltonbsd.com>
256%
257To see all of the directories on your FreeBSD system, type
258
259	find / -type d | less
260
261All the files?
262
263	find / -type f | less
264%
265To see how long it takes a command to run, type the word "time" before the
266command name.
267		-- Dru <genesis@istar.ca>
268%
269To see how much disk space is left on your UFS partitions, use
270
271	df -h
272		-- Dru <genesis@istar.ca>
273%
274To see the 10 largest files in a directory or on a UFS partition, use
275
276	du -h /partition_or_directory_name | sort -rh | head
277		-- Dru <genesis@istar.ca>
278%
279To see the IP addresses currently set on your active interfaces, type
280"ifconfig -u".
281		-- Dru <genesis@istar.ca>
282%
283To see the last 10 lines of a long file, use "tail filename". To see the
284first 10 lines, use "head filename". To see new lines as they're appended
285to a file, use "tail -f filename".
286		-- Dru <genesis@istar.ca>
287%
288To see the last time that you logged in, use lastlogin(8).
289		-- Dru <genesis@istar.ca>
290%
291To see the MAC addresses of the NICs on your system, type
292
293	ifconfig -a
294		-- Dru <genesis@istar.ca>
295%
296To see the output from when your computer started, run dmesg(8).  If it has
297been replaced with other messages, look at /var/run/dmesg.boot.
298		-- Francisco Reyes <lists@natserv.com>
299%
300Want colour in your directory listings?  Use "ls -G".  "ls -F" is also useful,
301and they can be combined as "ls -FG".
302%
303Want to find a specific port? Just type the following under /usr/ports
304or one of its subdirectories:
305
306	make search name=<port-name>
307    or
308	make search key=<keyword>
309%
310Want to know how many words, lines, or bytes are contained in a file? Type
311"wc filename".
312		-- Dru <genesis@istar.ca>
313%
314Want to see how much virtual memory you're using? Just type "swapinfo" to
315be shown information about the usage of your swap partitions.
316%
317Want to strip UTF-8 BOM(Byte Order Mark) from given files?
318
319	sed -e '1s/^\xef\xbb\xbf//' < bomfile > newfile
320%
321Want to use sed(1) to edit a file in place?  Well, to replace every 'e' with
322an 'o', in a file named 'foo', you can do:
323
324	sed -i.bak s/e/o/g foo
325
326And you'll get a backup of the original in a file named 'foo.bak', but if you
327want no backup:
328
329	sed -i '' s/e/o/g foo
330%
331When you've made modifications to a file in vi(1) and then find that
332you can't write it, type ``<ESC>!rm -f %'' then ``:w!'' to force the
333write
334
335This won't work if you don't have write permissions to the directory
336and probably won't be suitable if you're editing through a symbolic link.
337
338If you have sudo(8) installed and permissions to use it, type
339``<ESC>w ! sudo tee %'' to force a write.
340%
341You can adjust the volume of various parts of the sound system in your
342computer by typing 'mixer <type>.volume=<volume>'.  To get a list of what
343you can adjust, just type 'mixer'.
344%
345You can automatically download and install binary packages by doing
346
347	pkg install <package>
348
349This will also automatically install the packages that are dependencies
350for the package you install (ie, the packages it needs in order to work.)
351%
352You can change the video mode on all consoles by adding something like
353the following to /etc/rc.conf:
354
355	allscreens="80x30"
356
357You can use "vidcontrol -i mode | grep T" for a list of supported text
358modes.
359		-- Konstantinos Konstantinidis <kkonstan@duth.gr>
360%
361You can disable tcsh's terminal beep if you `set nobeep'.
362%
363You can install extra packages for FreeBSD by using the ports system.
364If you have installed it, you can download, compile, and install software by
365just typing
366
367	# cd /usr/ports/<category>/<portname>
368	# make install && make clean
369
370as root.  The ports infrastructure will download the software, change it so
371it works on FreeBSD, compile it, install it, register the installation so it
372will be possible to automatically uninstall it, and clean out the temporary
373working space it used.  You can remove an installed port you decide you do not
374want after all by typing
375
376	# cd /usr/ports/<category>/<portname>
377	# make deinstall
378
379as root.
380%
381You can look through a file in a nice text-based interface by typing
382
383	less filename
384%
385You can make a log of your terminal session with script(1).
386%
387You can often get answers to your questions about FreeBSD by searching in the
388FreeBSD mailing list archives at
389
390	http://freebsd.markmail.org
391%
392You can open up a new split-screen window in (n)vi with :N or :E and then
393use ^w to switch between the two.
394%
395You can permanently set environment variables for your shell by putting them
396in a startup file for the shell.  The name of the startup file varies
397depending on the shell - csh and tcsh uses .login, bash, sh, ksh and zsh use
398.profile.  When using bash, sh, ksh or zsh, don't forget to export the
399variable.
400%
401You can press Ctrl-D to quickly exit from a shell, or logout from a
402login shell.
403		-- Konstantinos Konstantinidis <kkonstan@duth.gr>
404%
405You can press up-arrow or down-arrow to walk through a list of
406previous commands in tcsh.
407%
408You can search for documentation on a keyword by typing
409
410	apropos keyword
411%
412You can `set autologout = 30' to have tcsh log you off automatically
413if you leave the shell idle for more than 30 minutes.
414%
415You can use aliases to decrease the amount of typing you need to do to get
416commands you commonly use.  Examples of fairly popular aliases include (in
417Bourne shell style, as in /bin/sh, bash, ksh, and zsh):
418
419	alias lf="ls -FA"
420	alias ll="ls -lA"
421	alias su="su -m"
422
423In csh or tcsh, these would be
424
425	alias lf ls -FA
426	alias ll ls -lA
427	alias su su -m
428
429To remove an alias, you can usually use 'unalias aliasname'.  To list all
430aliases, you can usually type just 'alias'.
431%
432You can use /etc/make.conf to control the options used to compile software
433on this system.  Example entries are in
434/usr/share/examples/etc/make.conf and in make.conf(5).
435For options that are set for building FreeBSD's kernel and its world, see
436src.conf(5).
437%
438You can use "pkg info" to see a list of packages you have installed.
439%
440You can use the 'fetch' command to retrieve files over ftp, http or https.
441
442	 fetch https://www.FreeBSD.org/images/beastie.png
443
444will download the beastie image from the FreeBSD web site.
445%
446You can use "whereis" to search standard binary, manual page and source
447directories for the specified programs. This can be particularly handy
448when you are trying to find where in the ports tree an application is.
449
450Try "whereis firefox" and "whereis whereis".
451		-- Konstantinos Konstantinidis <kkonstan@duth.gr>
452%
453Want to run the same command again?
454In many shells (e.g., tcsh, zsh, bash) you can type "!!".
455%
456Want to go the directory you were just in?
457Type "cd -"
458%
459Can't delete /usr/obj? Enter "chflags -R noschg /usr/obj" to remove the
460system immutable flag for all files in /usr/obj.
461
462		-- Lars Engels <lme@FreeBSD.org>
463%
464Want to list all files of an installed package? Enter
465"pkg info -l packagename".
466
467		-- Lars Engels <lme@FreeBSD.org>
468%
469Are you looking for a package? Search for it with
470"pkg search part_of_package_name"
471
472		-- Lars Engels <lme@FreeBSD.org>
473%
474If you want to recursively copy a directory preserving file and directory
475attributes use
476"cp -a source target"
477
478		-- Lars Engels <lme@FreeBSD.org>
479%
480Do you wonder what a terminal program is doing at the moment? dd(1) does not
481show any throughput? Hit "^T" (Control + t) to send SIGINFO to the process
482and see what it is doing.
483
484		-- Lars Engels <lme@FreeBSD.org>
485%
486Do you want to know which version of FreeBSD you are running? Enter
487"freebsd-version -ku" to display kernel and userland version.
488
489		-- Lars Engels <lme@FreeBSD.org>
490%
491If you want to end one or more processes at a time using a regular expression
492enter "pkill regex".
493
494		-- Lars Engels <lme@FreeBSD.org>
495%
496Do you want to run a program directly after some other process has ended? Use
497"pwait pid && new_program"
498
499		-- Lars Engels <lme@FreeBSD.org>
500%
501When you want your users to be able to reboot or shutdown FreeBSD, add them
502to the group "operator" and they are allowed to use shutdown(8) and poweroff(8).
503
504		-- Lars Engels <lme@FreeBSD.org>
505%
506If you need to create a FAT32 formatted USB thumb drive, find out its devicename
507running dmesg(8) after inserting it. Then create an MBR schema, a single slice and
508format it:
509
510# gpart create -s MBR ${devicename}
511# gpart add -t fat32 ${devicename}
512# newfs_msdos -F 32 -L thumbdrive ${devicename}s1
513
514		-- Lars Engels <lme@FreeBSD.org>
515%
516If you want to get a sorted list of all services that are started when FreeBSD boots,
517enter "service -e".
518
519		-- Lars Engels <lme@FreeBSD.org>
520%
521To easily configure your installed FreeBSD use bsdconfig(8).
522
523		-- Lars Engels <lme@FreeBSD.org>
524%
525After you compiled and installed a new version of FreeBSD, use etcupdate(8) to merge
526configuration updates.
527Run "etcupdate extract" once when your sources match your running system, then run
528"etcupdate" after every upgrade and "etcupdate resolve" to resolve any conflicts.
529
530		-- Lars Engels <lme@FreeBSD.org>
531%
532Do you want to do a binary upgrade of your running FreeBSD installation? Use freebsd-update(8).
533
534To install updates and patches for the running branch use
535# freebsd-update fetch install
536
537To upgrade to a newer release use
538# freebsd-update upgrade -r ${name_of_release}
539
540		-- Lars Engels <lme@FreeBSD.org>
541%
542To run rc scripts in /etc/rc.d and /usr/local/etc/rc.d use service(8).
543Run "service ${name_of_rc_script} start" to start a daemon and
544"service ${name_of_rc_script} stop" to stop it.
545
546		-- Lars Engels <lme@FreeBSD.org>
547%
548If you don't want to edit /etc/rc.conf directly, use sysrc(8) to add and remove entries.
549Use "sysrc name=value" to add an entry and "sysrc -x name" to delete an entry.
550
551		-- Lars Engels <lme@FreeBSD.org>
552%
553You can upload the dmesg of your system to help developers get an overview of commonly
554used hardware and peripherals for FreeBSD. Use the curl package to upload it like this:
555curl -v -d "nickname=$USER" -d "description=FreeBSD/$(uname -m) on \
556$(kenv smbios.system.maker) $(kenv smbios.system.product)" -d "do=addd" \
557--data-urlencode 'dmesg@/var/run/dmesg.boot' http://dmesgd.nycbug.org/index.cgi
558%
559Want to know how much memory (in bytes) your machine has installed? Let
560sysctl(8) tell you with the following command:
561
562sysctl hw.realmem
563
564The realmem value is memory before the kernel and modules are loaded, whereas
565hw.physmem is what is left after they were loaded.
566
567The number of active CPUs is displayed using this command:
568
569sysctl hw.ncpu
570
571		-- Benedict Reuschling <bcr@FreeBSD.org>
572%
573When using ZFS as the file system the "df" command is reporting the pool size
574and not file system sizes. It also does not know about descendent ZFS
575datasets, snapshots, quotas, and reservations with their individual space usage.
576Use the built-in "zfs list" command to get a better overview of space usage:
577
578zfs list -o space
579
580		-- Benedict Reuschling <bcr@FreeBSD.org>
581%
582To learn more about what your system is doing, take a look at systat(1). For
583example, to get various statistics related to virtual memory usage, process
584scheduling, device interrupts, system name translation caching, and disk I/O,
585enter the following:
586
587systat -vmstat
588
589Other values are icmp, icmp6, ifstat, iostat, ip, ip6, netstat, pigs, sctp,
590swap, tcp, or zarc. You can switch between displays using :<display> and exit
591back to your shell by typing
592
593:quit
594
595		-- Benedict Reuschling <bcr@FreeBSD.org>
596%
597To set a quota of 10 GB for the user named foo on a ZFS dataset, run the
598following command:
599
600# zfs set userquota@foo=10G pool/home/foo
601
602The zfs userspace command can display the quota and current space usage:
603
604# zfs userspace pool/home/foo
605
606To unset a quota, assign "none" as the value.
607		-- Benedict Reuschling <bcr@FreeBSD.org>
608%
609ZFS can display I/O statistics for a given pool using the iostat subcommand.
610By default, it will display one line of current activity.  To display stats
611every 5 seconds run the following command (cancel with CTRL+C):
612
613zpool iostat 5
614
615To view individual disk activities, specify the -v parameter:
616
617zpool iostat -v
618
619Of course, both can be combined. For more options, see zpool(8).
620		-- Benedict Reuschling <bcr@FreeBSD.org>
621%
622FreeBSD's top(1) utility displays CPU statistics by default.
623To display I/O activity for each process instead, run top like this:
624
625top -m io
626
627		-- Benedict Reuschling <bcr@FreeBSD.org>
628%
629ZFS keeps a history of commands run against a specific pool using the
630history subcommand to zpool:
631
632zpool history
633
634More details are available using the -i and -l parameters. Note that ZFS
635will not keep the complete pool history forever and will remove older
636events in favor of never ones.
637		-- Benedict Reuschling <bcr@FreeBSD.org>
638%
639To display the compression ratio for the ZFS dataset /var/log on the pool
640mypool, run the following command:
641
642zfs get refcompressratio mypool/var/log
643
644The refcompressratio will only display the compression ratio for that specific
645dataset, not the descendant datasets. To include the child datasets, the
646command looks like this:
647
648zfs get compressratio mypool/var
649
650		-- Benedict Reuschling <bcr@FreeBSD.org>
651%
652You can limit the depth of the displayed datasets in the "zfs list" output
653using the -d parameter. To display only the first level of datasets below
654mypool/usr and not the ones deeper than those, run this command:
655
656zfs list -d 1 mypool/usr
657
658		-- Benedict Reuschling <bcr@FreeBSD.org>
659%
660The "zfs list" command can be filtered in multiple ways. To display just
661the dataset name, use the -o parameter:
662
663zfs list -o name mypool/usr
664
665More columns and their order can be defined by separating them with commas:
666
667zfs list -o mountpoint,name,avail
668
669		-- Benedict Reuschling <bcr@FreeBSD.org>
670%
671The output of "zfs list" can be sorted by a specific column using -s.  To
672sort the datasets by the "used" column in ascending order, run this command:
673
674zfs list -s used
675
676To sort in descending order instead, use -S:
677
678zfs list -S used
679
680		-- Benedict Reuschling <bcr@FreeBSD.org>
681%
682To make the "zfs list" output more script-friendly, you can suppress the
683output of the headers for each column by passing the -H parameter:
684
685zfs list -H
686
687Another helpful option for script writers is -p, which displays the numbers
688in non-rounded, exact values:
689
690zfs list -p
691
692		-- Benedict Reuschling <bcr@FreeBSD.org>
693%
694Before deleting a dataset or snapshot, perform a dry run using the -n
695parameter. This is to make sure you really want to delete just that
696dataset/snapshot and not any dependent ones. ZFS will display the resulting
697action when -n is combined with the -v option without actually performing
698it:
699
700zfs destroy -nrv mypool@mysnap
701
702Once you are sure this is exactly what you intend to do, remove the -n
703parameter to execute the destroy operation.
704		-- Benedict Reuschling <bcr@FreeBSD.org>
705%
706You can delete a range of ZFS snapshots (a-z) in multiple ways.
707The following will delete d and all earlier snapshots:
708
709zfs destroy mypool/data@%d
710
711To delete d and all later snapshots:
712
713zfs destroy mypool/data@d%
714
715To delete all dataset snapshots:
716
717zfs destroy mypool/data@%
718
719Make sure to let ZFS perform a dry run (-n option) first and display (-v) what
720it would do to confirm that the delete operation is removing exactly what you
721intended.
722		-- Benedict Reuschling <bcr@FreeBSD.org>
723%
724To set a custom ZFS property on the mypool pool, you need to provide it
725using the "key1:key2=value" syntax, where the colon (:) is used as the
726separator and identifier from the built-in ZFS properties:
727
728# zfs set warranty:expires=2038-01-19 mypool
729
730The custom property is applied to all datasets and can be queried like any
731built-in properties using zfs get:
732
733zfs get warranty:expires mypool
734
735To reset the value of a custom property, use the inherit subcommand:
736
737# zfs inherit warranty:expires mypool
738
739Removing a custom property from a pool is done using the -r flag to the
740"zfs inherit" command:
741
742# zfs inherit -r warranty:expires mypool
743
744		-- Benedict Reuschling <bcr@FreeBSD.org>
745%
746To delete a range of ZFS snapshots, use the % (percent) character after the
747full path to the first snapshot that should be included. For example, to
748simulate deleting snapshots a through (including) d, use this command:
749
750# zfs destroy -rvn mypool/tmp@a%d
751
752Once you are sure that this is what you want, remove the -n option:
753
754# zfs destroy -rv mypool/tmp@a%d
755
756		-- Benedict Reuschling <bcr@FreeBSD.org>
757%
758You can prevent the removal of a ZFS snapshot by using the hold subcommand.
759For example, to prevent the snapshot called milestone from deletion, run the
760following command:
761
762# zfs hold milestone_hold mypool/projects@my_milestone
763
764The "zfs holds" command will list all current snapshots that are protected
765this way (-r for a recursive list):
766
767# zfs holds -r mypool
768
769The TIMESTAMP column in the output of the above command is from when the
770hold was created, not the snapshot it holds. The "zfs destroy" command will
771echo a "dataset is busy" message on the console when it encounters a hold.
772Use "zfs release" to release the hold on the snapshot:
773
774# zfs release milestone_hold mypool/projects@my_milestone
775
776		-- Benedict Reuschling <bcr@FreeBSD.org>
777%
778A user "sender" needs the following permissions set to send a ZFS dataset:
779
780# zfs allow -u sender send,snapshot txpool
781
782On the receiving side, the user "receiver" requires these permissions:
783
784# zfs allow -u receiver compression,mountpoint,mount,create,receive rxpool
785
786		-- Benedict Reuschling <bcr@FreeBSD.org>
787%
788Don't let your zpool fill up completely by creating a dataset with
789reservation.
790
791# zfs create -o refreservation=<5% of total pool space> <poolname>/reserved
792
793You can always shrink the reserve if you need the space, but your pool will
794always have space left this way.
795
796		-- Benedict Reuschling <bcr@FreeBSD.org>
797%
798Sometimes a single slow HDD can cripple the performance of your entire system.
799You can spot one like this:
800
801# gstat -I5s | sort -rn -k9 | head
802
803		-- Alan Somers <asomers@FreeBSD.org>
804%
805FreeBSD's ps(1) can create a dependency tree based on parent/child
806relationships between processes, like this:
807
808$ ps -d
809
810		-- Daniel Ebdrup Jensen <debdrup@FreeBSD.org>
811%
812It is possible to measure the resident memory set:
813
814$ vmstat -o | awk 'NR>1 { t[$7] += $1 } \
815END { for (i in t) printf "%s %d\n",i,t[i] }'
816
817The rows have the following meaning:
818df = default (not assigned a specific pager)
819sw = swap
820df = virtual
821vn = vnode
822ph = heap
823md = memory device
824
825This will be reported in number of pages, so it needs to be multiplied by the
826page size of the architecture which can be found via:
827
828$ sysctl -n hw.pagesize
829
830		-- Daniel Ebdrup Jensen <debdrup@FreeBSD.org>
831%
832To establish a serial connection to anything including a USB device,
833nothing more than cu(1) is needed:
834
835$ cu -s 9600 -l /dev/ttyU0
836
837		-- Daniel Ebdrup Jensen <debdrup@FreeBSD.org>
838%
839You can control kernel stack(9) traces on ^T (tty info) by setting
840kern.tty_info_kstacks to 0 (off), 1 (on), or 2 (verbose), e.g.:
841
842# sysctl kern.tty_info_kstacks=2
843
844		-- Michael Gmelin <grembo@FreeBSD.org>
845%
846