Manual Pages for UNIX Operating System command usage for man isaexec

Standard C Library Functions                          isaexec(3C)



NAME
     isaexec - invoke isa-specific executable

SYNOPSIS
     #include 

     int isaexec(const char *path, char *const argv[], char *const envp[]);


DESCRIPTION
     The isaexec() function takes the path specified as path  and
     breaks  it  into  directory  and  file  name  components. It
     enquires from the  running  system  the  list  of  supported
     instruction  set architectures; see isalist(5). The function
     traverses the list for an executable file in named subdirec-
     tories  of  the  original  directory.   When  such a file is
     located, execve() is invoked with  argv[]  and  envp[].  See
     exec(2).

RETURN VALUES
     If no file  is  located,  isaexec()  returns  ENOENT.  Other
     return values are the same as for execve().

EXAMPLES
     Example 1 Example of isaexec() function.


     On a system whose isalist is


       sparcv7 sparc



     the program


       int
       main(int argc, char *argv[], char *envp[])
       {
               return (isaexec("/bin/thing", argv, envp));
       }



     will   look   first   for   an   executable    file    named
     /bin/sparcv7/thing,   then  for  an  executable  file  named
     /bin/sparc/thing. It will invoke execve() on the first  exe-
     cutable file it finds named thing.






SunOS 5.11          Last change: 20 Mar 1998                    1






Standard C Library Functions                          isaexec(3C)



     On that same system, a program called /u/bin/tofu can  cause
     either   /u/bin/sparcv7/tofu   or  /u/bin/sparc/tofu  to  be
     invoked using the following code:


       int
       main(int argc, char *argv[], char *envp[])
       {
                     return (isaexec(getexecname(), argv, envp));
       }


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | Safe                        |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|


SEE ALSO
     exec(2), getexecname(3C), attributes(5), isalist(5)


























SunOS 5.11          Last change: 20 Mar 1998                    2