basename

 

---

 
 
 
 User Commands                                         basename(1)
 
 
 


NAME
      basename, dirname - deliver portions of path names
 


SYNOPSIS
      /usr/bin/basename string  [ suffix ]
 
      /usr/xpg4/bin/basename string  [ suffix ]
 
      dirname string
 


DESCRIPTION
      The basename utility deletes any prefix ending in / and  the
      suffix  (if  present  in string) from string, and prints the
      result on the standard output. It is  normally  used  inside
      substitution marks (``) within shell procedures.
 
   /usr/bin/basename
      The suffix is a pattern defined on the expr(1) manual page.
 
   /usr/xpg4/bin/basename
      The suffix is a string with no special significance attached
      to  any of the characters it contains.
 
      The dirname utility delivers all but the last level  of  the
      path name in string.
 
 EXAMPLES
      Example 1: Examples of the basename command.
 
      The   following   example,   invoked   with   the   argument
      /home/sms/personal/mail  sets  the environment variable NAME
      to the file named mail and the environment variable  MYMAIL-
      PATH to the string  /home/sms/personal:
 
      example% NAME=`basename $HOME/personal/mail`
      example% MYMAILPATH=`dirname $HOME/personal/mail`
 
      This   shell   procedure,   invoked   with   the    argument
      /usr/src/bin/cat.c,  compiles  the  named file and moves the
      output to cat in the current directory:
 
      example% cc $1
      example% mv a.out `basename $1 .c`
 
 ENVIRONMENT VARIABLES
      See environ(5) for descriptions of the following environment
      variables  that  affect  the execution of basename and  dir-
      name: LC_CTYPE, LC_MESSAGES, and NLSPATH.
 
 EXIT STATUS
      The following exit values are returned:
 
 
 
 
 SunOS 5.8           Last change: 18 Mar 1997                    1
 
 
 
 
 
 
 User Commands                                         basename(1)
 
 
 
      0     Successful completion.
 
      >0    An error occurred.
 


ATTRIBUTES
      See attributes(5) for descriptions of the  following  attri-
      butes:
 
   /usr/bin/basename
      ____________________________________________________________
     |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
     |_____________________________|_____________________________|
     | Availability                | SUNWcsu                     |
     |_____________________________|_____________________________|
 
 
   /usr/xpg4/bin/basename
      ____________________________________________________________
     |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
     |_____________________________|_____________________________|
     | Availability                | SUNWxcu4                    |
     |_____________________________|_____________________________|
 
 


SEE ALSO
      expr(1), attributes(5), environ(5), XPG4(5)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 SunOS 5.8           Last change: 18 Mar 1997                    2
 
 
 

---