File: basename.1

package info (click to toggle)
coreutils 9.10-1
  • links: PTS
  • area: main
  • in suites: forky, sid
  • size: 70,560 kB
  • sloc: ansic: 253,546; sh: 30,931; perl: 8,141; yacc: 1,846; makefile: 198; python: 47; sed: 16
file content (68 lines) | stat: -rw-r--r-- 2,356 bytes parent folder | download
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
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.50.1.
.TH BASENAME "1" "February 2026" "GNU coreutils 9.10" "User Commands"
.SH NAME
basename \- strip directory and suffix from filenames
.SH SYNOPSIS
.B basename
\fI\,NAME \/\fR[\fI\,SUFFIX\/\fR]
.br
.B basename
\fI\,OPTION\/\fR... \fI\,NAME\/\fR...
.SH DESCRIPTION
.\" Add any additional description here
.PP
Print NAME with any leading directory components removed.
If specified, also remove a trailing SUFFIX.
.PP
Mandatory arguments to long options are mandatory for short options too.
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#basename-a'\fB\-a, \-\-multiple\fP\X'tty: link'
support multiple arguments and treat each as a NAME
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#basename-s'\fB\-s, \-\-suffix=\,SUFFIX\fP\X'tty: link'\/\fR
remove a trailing SUFFIX; implies \fB\-a\fR
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#basename-z'\fB\-z, \-\-zero\fP\X'tty: link'
end each output line with NUL, not newline
.TP
\X'tty: link https://www.gnu.org/software/coreutils/basename#basename--help'\fB\-\-help\fP\X'tty: link'
display this help and exit
.TP
\X'tty: link https://www.gnu.org/software/coreutils/basename#basename--version'\fB\-\-version\fP\X'tty: link'
output version information and exit
.SH EXAMPLES
.TP
basename /usr/bin/sort
\-> "sort"
.TP
basename include/stdio.h .h
\-> "stdio"
.TP
basename \-s .h include/stdio.h
\-> "stdio"
.TP
basename \-a any/str1 any/str2
\-> "str1" followed by "str2"
.SH AUTHOR
Written by David MacKenzie.
.SH "REPORTING BUGS"
Report bugs to: bug\-coreutils@gnu.org
.br
GNU coreutils home page: <https://www.gnu.org/software/coreutils/>
.br
General help using GNU software: <https://www.gnu.org/gethelp/>
.br
Report any translation bugs to <https://translationproject.org/team/>
.SH COPYRIGHT
Copyright \(co 2026 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
\fBdirname\fP(1), \fBreadlink\fP(1)
.PP
.br
Full documentation <https://www.gnu.org/software/coreutils/basename>
.br
or available locally via: info \(aq(coreutils) basename invocation\(aq