Synopsis - man pages section 3: Basic Library Functions

Skip Navigation Links
Exit Print View
	man pages section 3: Basic Library Functions Oracle Solaris 11.1 Information Library

Oracle Technology Network

Document Information

Basic Library Functions

addrtosymstr(3C)

addseverity(3C)

aio_cancel(3C)

aiocancel(3C)

aio_error(3C)

aio_fsync(3C)

aio_return(3C)

aio_suspend(3C)

aio_waitn(3C)

aio_write(3C)

alphasort(3C)

asctime_r(3C)

atomic_add_16(3C)

atomic_add_16_nv(3C)

atomic_add_32(3C)

atomic_add_32_nv(3C)

atomic_add(3C)

atomic_add_64(3C)

atomic_add_64_nv(3C)

atomic_add_8(3C)

atomic_add_8_nv(3C)

atomic_add_char(3C)

atomic_add_char_nv(3C)

atomic_add_int(3C)

atomic_add_int_nv(3C)

atomic_add_long(3C)

atomic_add_long_nv(3C)

atomic_add_ptr(3C)

atomic_add_ptr_nv(3C)

atomic_add_short(3C)

atomic_add_short_nv(3C)

atomic_and_16(3C)

atomic_and_16_nv(3C)

atomic_and_32(3C)

atomic_and_32_nv(3C)

atomic_and(3C)

atomic_and_64(3C)

atomic_and_64_nv(3C)

atomic_and_8(3C)

atomic_and_8_nv(3C)

atomic_and_uchar(3C)

atomic_and_uchar_nv(3C)

atomic_and_uint(3C)

atomic_and_uint_nv(3C)

atomic_and_ulong(3C)

atomic_and_ulong_nv(3C)

atomic_and_ushort(3C)

atomic_and_ushort_nv(3C)

atomic_bits(3C)

atomic_cas_16(3C)

atomic_cas_32(3C)

atomic_cas(3C)

atomic_cas_64(3C)

atomic_cas_8(3C)

atomic_cas_ptr(3C)

atomic_cas_uchar(3C)

atomic_cas_uint(3C)

atomic_cas_ulong(3C)

atomic_cas_ushort(3C)

atomic_clear_long_excl(3C)

atomic_dec_16(3C)

atomic_dec_16_nv(3C)

atomic_dec_32(3C)

atomic_dec_32_nv(3C)

atomic_dec(3C)

atomic_dec_64(3C)

atomic_dec_64_nv(3C)

atomic_dec_8(3C)

atomic_dec_8_nv(3C)

atomic_dec_ptr(3C)

atomic_dec_ptr_nv(3C)

atomic_dec_uchar(3C)

atomic_dec_uchar_nv(3C)

atomic_dec_uint(3C)

atomic_dec_uint_nv(3C)

atomic_dec_ulong(3C)

atomic_dec_ulong_nv(3C)

atomic_dec_ushort(3C)

atomic_dec_ushort_nv(3C)

atomic_inc_16(3C)

atomic_inc_16_nv(3C)

atomic_inc_32(3C)

atomic_inc_32_nv(3C)

atomic_inc(3C)

atomic_inc_64(3C)

atomic_inc_64_nv(3C)

atomic_inc_8(3C)

atomic_inc_8_nv(3C)

atomic_inc_ptr(3C)

atomic_inc_ptr_nv(3C)

atomic_inc_uchar(3C)

atomic_inc_uchar_nv(3C)

atomic_inc_uint(3C)

atomic_inc_uint_nv(3C)

atomic_inc_ulong(3C)

atomic_inc_ulong_nv(3C)

atomic_inc_ushort(3C)

atomic_inc_ushort_nv(3C)

atomic_ops(3C)

atomic_or_16(3C)

atomic_or_16_nv(3C)

atomic_or_32(3C)

atomic_or_32_nv(3C)

atomic_or(3C)

atomic_or_64(3C)

atomic_or_64_nv(3C)

atomic_or_8(3C)

atomic_or_8_nv(3C)

atomic_or_uchar(3C)

atomic_or_uchar_nv(3C)

atomic_or_uint(3C)

atomic_or_uint_nv(3C)

atomic_or_ulong(3C)

atomic_or_ulong_nv(3C)

atomic_or_ushort(3C)

atomic_or_ushort_nv(3C)

atomic_set_long_excl(3C)

atomic_swap_16(3C)

atomic_swap_32(3C)

atomic_swap(3C)

atomic_swap_64(3C)

atomic_swap_8(3C)

atomic_swap_ptr(3C)

atomic_swap_uchar(3C)

atomic_swap_uint(3C)

atomic_swap_ulong(3C)

atomic_swap_ushort(3C)

backtrace(3C)

backtrace_symbols(3C)

backtrace_symbols_fd(3C)

bindtextdomain(3C)

bind_textdomain_codeset(3C)

bsdmalloc(3MALLOC)

bsd_signal(3C)

calloc(3MALLOC)

canonicalize_file_name(3C)

cfgetispeed(3C)

cfgetospeed(3C)

cfsetispeed(3C)

cfsetospeed(3C)

chkauthattr(3C)

clock_getres(3C)

clock_gettime(3C)

clock_nanosleep(3C)

clock_settime(3C)

closefrom(3C)

cond_broadcast(3C)

cond_destroy(3C)

cond_init(3C)

cond_reltimedwait(3C)

cond_signal(3C)

cond_timedwait(3C)

cond_wait(3C)

crypt_genhash_impl(3C)

crypt_gensalt(3C)

crypt_gensalt_impl(3C)

ctermid_r(3C)

dbm_clearerr(3C)

dbm_close(3C)

dbm_delete(3C)

dbm_error(3C)

dbm_fetch(3C)

dbm_firstkey(3C)

dbm_nextkey(3C)

dbm_store(3C)

dcgettext(3C)

dcngettext(3C)

decimal_to_double(3C)

decimal_to_extended(3C)

decimal_to_floating(3C)

decimal_to_quadruple(3C)

decimal_to_single(3C)

dl_iterate_phdr(3C)

dngettext(3C)

door_bind(3C)

door_call(3C)

door_create(3C)

door_cred(3C)

door_getparam(3C)

door_info(3C)

door_return(3C)

door_revoke(3C)

door_server_create(3C)

door_setparam(3C)

door_ucred(3C)

door_unbind(3C)

door_xcreate(3C)

double_to_decimal(3C)

enable_extended_FILE_stdio(3C)

endauthattr(3C)

endexecattr(3C)

endnetgrent(3C)

endprofattr(3C)

enduserattr(3C)

endusershell(3C)

endutxent(3C)

_exithandle(3C)

extended_to_decimal(3C)

__fbufsize(3C)

fcloseall(3C)

fdatasync(3C)

fdopendir(3C)

fgetgrent(3C)

fgetgrent_r(3C)

fgetpwent(3C)

fgetpwent_r(3C)

fgetspent(3C)

fgetspent_r(3C)

fgetuserattr(3C)

file_to_decimal(3C)

floating_to_decimal(3C)

flockfile(3C)

_flushlbf(3C)

__fpending(3C)

fpgetmask(3C)

fpgetround(3C)

fpgetsticky(3C)

fpsetmask(3C)

fpsetround(3C)

fpsetsticky(3C)

__freadable(3C)

__freading(3C)

frealpath(3C)

free(3MALLOC)

free_authattr(3C)

free_execattr(3C)

free_profattr(3C)

free_proflist(3C)

free_userattr(3C)

__fsetlocking(3C)

ftruncate(3C)

ftrylockfile(3C)

func_to_decimal(3C)

funlockfile(3C)

__fwritable(3C)

__fwriting(3C)

getattrat(3C)

getauthattr(3C)

getauthnam(3C)

getchar_unlocked(3C)

getc_unlocked(3C)

getdtablesize(3C)

getexecattr(3C)

getexecname(3C)

getexecprof(3C)

getexecuser(3C)

getextmntent(3C)

getgrent_r(3C)

getgrgid_r(3C)

getgrnam_r(3C)

gethomelgroup(3C)

gethostid(3C)

gethostname(3C)

gethrtime(3C)

gethrvtime(3C)

getloadavg(3C)

getlogin_r(3C)

getmntany(3C)

getmntent(3C)

getnetgrent(3C)

getnetgrent_r(3C)

get_nprocs(3C)

get_nprocs_conf(3C)

getopt_clip(3C)

getopt_long(3C)

getopt_long_only(3C)

getpagesize(3C)

getpagesizes(3C)

getpassphrase(3C)

getpeerucred(3C)

getpriority(3C)

getprofattr(3C)

getproflist(3C)

getprofnam(3C)

getprogname(3C)

getpwent_r(3C)

getpwnam_r(3C)

getpwuid_r(3C)

getrusage(3C)

getspent_r(3C)

getspnam_r(3C)

getsubopt(3C)

gettimeofday(3C)

getuserattr(3C)

getuserattrnam(3C)

getusernam(3C)

getusershell(3C)

getuseruid(3C)

getutline(3C)

getutxent(3C)

getutxline(3C)

getvfsany(3C)

getvfsent(3C)

getvfsfile(3C)

getvfsspec(3C)

getzoneid(3C)

getzoneidbyname(3C)

getzonenamebyid(3C)

hasmntopt(3C)

iconv_close(3C)

iconv_open(3C)

initgroups(3C)

initstate(3C)

isastream(3C)

isenglish(3C)

isideogram(3C)

isphonogram(3C)

isspecial(3C)

is_system_labeled(3C)

iswxdigit(3C)

kva_match(3C)

lio_listio(3C)

localeconv(3C)

localelist(3C)

localelistfree(3C)

localtime(3C)

localtime_r(3C)

makecontext(3C)

mallinfo(3MALLOC)

malloc(3MALLOC)

mallocctl(3MALLOC)

mallopt(3MALLOC)

mapmalloc(3MALLOC)

match_execattr(3C)

mbsrtowcs(3C)

memalign(3MALLOC)

membar_consumer(3C)

membar_enter(3C)

membar_exit(3C)

membar_ops(3C)

membar_producer(3C)

mq_getattr(3C)

mq_notify(3C)

mq_receive(3C)

mq_reltimedreceive_np(3C)

mq_reltimedsend_np(3C)

mq_setattr(3C)

mq_timedreceive(3C)

mq_timedsend(3C)

mq_unlink(3C)

mtmalloc(3MALLOC)

munlockall(3C)

mutex_consistent(3C)

mutex_destroy(3C)

mutex_init(3C)

mutex_lock(3C)

mutex_trylock(3C)

mutex_unlock(3C)

nanosleep(3C)

nl_langinfo(3C)

port_alert(3C)

port_associate(3C)

port_create(3C)

port_dissociate(3C)

port_getn(3C)

port_send(3C)

port_sendn(3C)

posix_fadvise(3C)

posix_fallocate(3C)

posix_madvise(3C)

posix_memalign(3C)

posix_openpt(3C)

posix_spawn(3C)

posix_spawnattr_destroy(3C)

posix_spawnattr_getflags(3C)

posix_spawnattr_getpgroup(3C)

posix_spawnattr_getschedparam(3C)

posix_spawnattr_getschedpolicy(3C)

posix_spawnattr_getsigdefault(3C)

posix_spawnattr_getsigignore_np(3C)

posix_spawnattr_getsigmask(3C)

posix_spawnattr_init(3C)

posix_spawnattr_setflags(3C)

posix_spawnattr_setpgroup(3C)

posix_spawnattr_setschedparam(3C)

posix_spawnattr_setschedpolicy(3C)

posix_spawnattr_setsigdefault(3C)

posix_spawnattr_setsigignore_np(3C)

posix_spawnattr_setsigmask(3C)

posix_spawn_file_actions_addclose(3C)

posix_spawn_file_actions_addclosefrom_np(3C)

posix_spawn_file_actions_adddup2(3C)

posix_spawn_file_actions_addopen(3C)

posix_spawn_file_actions_destroy(3C)

posix_spawn_file_actions_init(3C)

posix_spawnp(3C)

printstack(3C)

priv_addset(3C)

priv_allocset(3C)

priv_basicset(3C)

priv_copyset(3C)

priv_delset(3C)

priv_emptyset(3C)

priv_fillset(3C)

priv_freeset(3C)

priv_getbyname(3C)

priv_getbynum(3C)

priv_getsetbyname(3C)

priv_getsetbynum(3C)

priv_gettext(3C)

priv_ineffect(3C)

priv_intersect(3C)

priv_inverse(3C)

priv_isemptyset(3C)

priv_isequalset(3C)

priv_isfullset(3C)

priv_ismember(3C)

priv_issubset(3C)

priv_set_to_str(3C)

priv_str_to_set(3C)

priv_union(3C)

pset_getloadavg(3C)

pthread_atfork(3C)

pthread_attr_destroy(3C)

pthread_attr_getdetachstate(3C)

pthread_attr_getguardsize(3C)

pthread_attr_getinheritsched(3C)

pthread_attr_getschedparam(3C)

pthread_attr_getschedpolicy(3C)

pthread_attr_getscope(3C)

pthread_attr_getstack(3C)

pthread_attr_getstackaddr(3C)

pthread_attr_getstacksize(3C)

pthread_attr_init(3C)

pthread_attr_setdetachstate(3C)

pthread_attr_setguardsize(3C)

pthread_attr_setinheritsched(3C)

pthread_attr_setschedparam(3C)

pthread_attr_setschedpolicy(3C)

pthread_attr_setscope(3C)

pthread_attr_setstack(3C)

pthread_attr_setstackaddr(3C)

pthread_attr_setstacksize(3C)

pthread_barrierattr_destroy(3C)

pthread_barrierattr_getpshared(3C)

pthread_barrierattr_init(3C)

pthread_barrierattr_setpshared(3C)

pthread_barrier_destroy(3C)

pthread_barrier_init(3C)

pthread_barrier_wait(3C)

pthread_cancel(3C)

pthread_cleanup_pop(3C)

pthread_cleanup_push(3C)

pthread_condattr_destroy(3C)

pthread_condattr_getclock(3C)

pthread_condattr_getpshared(3C)

pthread_condattr_init(3C)

pthread_condattr_setclock(3C)

pthread_condattr_setpshared(3C)

pthread_cond_broadcast(3C)

pthread_cond_destroy(3C)

pthread_cond_init(3C)

pthread_cond_reltimedwait_np(3C)

pthread_cond_signal(3C)

pthread_cond_timedwait(3C)

pthread_cond_wait(3C)

pthread_create(3C)

pthread_detach(3C)

pthread_equal(3C)

pthread_exit(3C)

pthread_getconcurrency(3C)

pthread_getschedparam(3C)

pthread_getspecific(3C)

pthread_join(3C)

pthread_key_create(3C)

pthread_key_create_once_np(3C)

pthread_key_delete(3C)

pthread_kill(3C)

pthread_mutexattr_destroy(3C)

pthread_mutexattr_getprioceiling(3C)

pthread_mutexattr_getprotocol(3C)

pthread_mutexattr_getpshared(3C)

pthread_mutexattr_getrobust(3C)

pthread_mutexattr_gettype(3C)

pthread_mutexattr_init(3C)

pthread_mutexattr_setprioceiling(3C)

pthread_mutexattr_setprotocol(3C)

pthread_mutexattr_setpshared(3C)

pthread_mutexattr_setrobust(3C)

pthread_mutexattr_settype(3C)

pthread_mutex_consistent(3C)

pthread_mutex_destroy(3C)

pthread_mutex_getprioceiling(3C)

pthread_mutex_init(3C)

pthread_mutex_lock(3C)

pthread_mutex_reltimedlock_np(3C)

pthread_mutex_setprioceiling(3C)

pthread_mutex_timedlock(3C)

pthread_mutex_trylock(3C)

pthread_mutex_unlock(3C)

pthread_once(3C)

pthread_rwlockattr_destroy(3C)

pthread_rwlockattr_getpshared(3C)

pthread_rwlockattr_init(3C)

pthread_rwlockattr_setpshared(3C)

pthread_rwlock_destroy(3C)

pthread_rwlock_init(3C)

pthread_rwlock_rdlock(3C)

pthread_rwlock_reltimedrdlock_np(3C)

pthread_rwlock_reltimedwrlock_np(3C)

pthread_rwlock_timedrdlock(3C)

pthread_rwlock_timedwrlock(3C)

pthread_rwlock_tryrdlock(3C)

pthread_rwlock_trywrlock(3C)

pthread_rwlock_unlock(3C)

pthread_rwlock_wrlock(3C)

pthread_self(3C)

pthread_setcancelstate(3C)

pthread_setcanceltype(3C)

pthread_setconcurrency(3C)

pthread_setschedparam(3C)

pthread_setschedprio(3C)

pthread_setspecific(3C)

pthread_sigmask(3C)

pthread_spin_destroy(3C)

pthread_spin_init(3C)

pthread_spin_lock(3C)

pthread_spin_trylock(3C)

pthread_spin_unlock(3C)

pthread_testcancel(3C)

putchar_unlocked(3C)

putc_unlocked(3C)

putmntent(3C)

pututline(3C)

pututxline(3C)

qeconvert(3C)

qfconvert(3C)

qgconvert(3C)

quadruple_to_decimal(3C)

rctlblk_get_enforced_value(3C)

rctlblk_get_firing_time(3C)

rctlblk_get_global_action(3C)

rctlblk_get_global_flags(3C)

rctlblk_get_local_action(3C)

rctlblk_get_local_flags(3C)

rctlblk_get_privilege(3C)

rctlblk_get_recipient_pid(3C)

rctlblk_get_value(3C)

rctlblk_set_local_action(3C)

rctlblk_set_local_flags(3C)

rctlblk_set_privilege(3C)

rctlblk_set_recipient_pid(3C)

rctlblk_set_value(3C)

rctlblk_size(3C)

rctl_walk(3C)

readdir_r(3C)

realloc(3MALLOC)

resetmnttab(3C)

rewinddir(3C)

rwlock_destroy(3C)

rwlock_init(3C)

rw_rdlock(3C)

rw_tryrdlock(3C)

rw_trywrlock(3C)

rw_unlock(3C)

rw_wrlock(3C)

schedctl_exit(3C)

schedctl_init(3C)

schedctl_lookup(3C)

schedctl_start(3C)

schedctl_stop(3C)

sched_getparam(3C)

sched_get_priority_max(3C)

sched_get_priority_min(3C)

sched_getscheduler(3C)

sched_rr_get_interval(3C)

sched_setparam(3C)

sched_setscheduler(3C)

sched_yield(3C)

seconvert(3C)

sema_destroy(3C)

sema_init(3C)

semaphore(3C)

sema_post(3C)

sema_trywait(3C)

sema_wait(3C)

sem_close(3C)

sem_destroy(3C)

sem_getvalue(3C)

sem_reltimedwait_np(3C)

sem_timedwait(3C)

sem_trywait(3C)

sem_unlink(3C)

setattrat(3C)

setauthattr(3C)

setbuffer(3C)

setexecattr(3C)

sethostname(3C)

setlinebuf(3C)

setlocale(3C)

setlogmask(3C)

setnetgrent(3C)

setpriority(3C)

setprofattr(3C)

setprogname(3C)

settimeofday(3C)

setuserattr(3C)

setusershell(3C)

setutxent(3C)

sfconvert(3C)

sgconvert(3C)

shm_unlink(3C)

sigaddset(3C)

sigdelset(3C)

sigemptyset(3C)

sigfillset(3C)

sigignore(3C)

siginterrupt(3C)

sigismember(3C)

siglongjmp(3C)

sigsetjmp(3C)

sigsetops(3C)

sigtimedwait(3C)

sigwaitinfo(3C)

single_to_decimal(3C)

smt_pause(3C)

stack_getbounds(3C)

_stack_grow(3C)

stack_inbounds(3C)

stack_setbounds(3C)

stack_violation(3C)

strcasecmp(3C)

strcasestr(3C)

strchrnul(3C)

strerror_r(3C)

string_to_decimal(3C)

strncasecmp(3C)

strsignal(3C)

strtoimax(3C)

strtoumax(3C)

swapcontext(3C)

sync_instruction_memory(3C)

tcgetattr(3C)

tcgetpgrp(3C)

tcsendbreak(3C)

tcsetattr(3C)

tcsetpgrp(3C)

td_event_addset(3C_DB)

td_event_delset(3C_DB)

td_event_emptyset(3C_DB)

td_event_fillset(3C_DB)

td_eventisempty(3C_DB)

td_eventismember(3C_DB)

td_init(3C_DB)

td_log(3C_DB)

td_sync_get_info(3C_DB)

td_sync_get_stats(3C_DB)

td_sync_setstate(3C_DB)

td_sync_waiters(3C_DB)

td_ta_clear_event(3C_DB)

td_ta_delete(3C_DB)

td_ta_enable_stats(3C_DB)

td_ta_event_addr(3C_DB)

td_ta_event_getmsg(3C_DB)

td_ta_get_nthreads(3C_DB)

td_ta_get_ph(3C_DB)

td_ta_get_stats(3C_DB)

td_ta_map_addr2sync(3C_DB)

td_ta_map_id2thr(3C_DB)

td_ta_map_lwp2thr(3C_DB)

td_ta_new(3C_DB)

td_ta_reset_stats(3C_DB)

td_ta_setconcurrency(3C_DB)

td_ta_set_event(3C_DB)

td_ta_sync_iter(3C_DB)

td_ta_sync_tracking_enable(3C_DB)

td_ta_thr_iter(3C_DB)

td_ta_tsd_iter(3C_DB)

td_thr_clear_event(3C_DB)

td_thr_dbresume(3C_DB)

td_thr_dbsuspend(3C_DB)

td_thr_event_enable(3C_DB)

td_thr_event_getmsg(3C_DB)

td_thr_getcxregs(3C_DB)

td_thr_getcxregsize(3C_DB)

td_thr_getfpregs(3C_DB)

td_thr_getgregs(3C_DB)

td_thr_get_info(3C_DB)

td_thr_getxregs(3C_DB)

td_thr_getxregsize(3C_DB)

td_thr_lockowner(3C_DB)

td_thr_setcxregs(3C_DB)

td_thr_set_event(3C_DB)

td_thr_setfpregs(3C_DB)

td_thr_setgregs(3C_DB)

td_thr_setprio(3C_DB)

td_thr_setsigpending(3C_DB)

td_thr_setxregs(3C_DB)

td_thr_sigsetmask(3C_DB)

td_thr_sleepinfo(3C_DB)

td_thr_tlsbase(3C_DB)

td_thr_tsd(3C_DB)

td_thr_validate(3C_DB)

textdomain(3C)

thr_continue(3C)

thr_create(3C)

thr_getconcurrency(3C)

thr_getprio(3C)

thr_getspecific(3C)

thr_keycreate(3C)

thr_keycreate_once(3C)

thr_min_stack(3C)

thr_setconcurrency(3C)

thr_setprio(3C)

thr_setspecific(3C)

thr_sigsetmask(3C)

thr_stksegment(3C)

thr_suspend(3C)

thr_yield(3C)

timerclear(3C)

timer_create(3C)

timer_delete(3C)

timer_getoverrun(3C)

timer_gettime(3C)

timerisset(3C)

timer_settime(3C)

towctrans(3C)

ttyname_r(3C)

u8_strcmp(3C)

u8_textprep_str(3C)

u8_validate(3C)

uconv_u16tou32(3C)

uconv_u16tou8(3C)

uconv_u32tou16(3C)

uconv_u32tou8(3C)

uconv_u8tou16(3C)

uconv_u8tou32(3C)

ucred_free(3C)

ucred_get(3C)

ucred_getegid(3C)

ucred_geteuid(3C)

ucred_getgroups(3C)

ucred_getlabel(3C)

ucred_getpflags(3C)

ucred_getpid(3C)

ucred_getprivset(3C)

ucred_getprojid(3C)

ucred_getrgid(3C)

ucred_getruid(3C)

ucred_getsgid(3C)

ucred_getsuid(3C)

ucred_getzoneid(3C)

ucred_size(3C)

umem_alloc(3MALLOC)

umem_cache_alloc(3MALLOC)

umem_cache_create(3MALLOC)

umem_cache_destroy(3MALLOC)

umem_cache_free(3MALLOC)

umem_debug(3MALLOC)

umem_free(3MALLOC)

umem_nofail_callback(3MALLOC)

umem_zalloc(3MALLOC)

unordered(3C)

utmpxname(3C)

valloc(3MALLOC)

vasprintf(3C)

vfwprintf(3C)

vsnprintf(3C)

vswprintf(3C)

walkcontext(3C)

watchmalloc(3MALLOC)

wcscasecmp(3C)

wcsncasecmp(3C)

wcsrtombs(3C)

wcstoimax(3C)

wcstoumax(3C)

wscasecmp(3C)

wsncasecmp(3C)

getusershell

, setusershell

, endusershell

- get legal user shells

Synopsis

#include <unistd.h>

char *getusershell(void);

void setusershell(void);

void endusershell(void);

Description

The getusershell() function returns a pointer to a legal user shell as defined by the system manager in the file /etc/shells. If /etc/shells does not exist, the following locations of the standard system shells are used in its place:

`/bin/bash`	`/bin/csh`
`/bin/jsh`	`/bin/ksh`
`/bin/ksh93`	`/bin/pfbash`
`/bin/pfcsh`	`/bin/pfksh`
`/bin/pfksh93`	`/bin/pfsh`
`/bin/pftcsh`	`/bin/pfzsh`
`/bin/sh`	`/bin/tcsh`
`/bin/zsh`	`/sbin/jsh`
`/sbin/pfsh`	`/sbin/sh`
`/usr/bin/bash`	`/usr/bin/csh`
`/usr/bin/jsh`	`/usr/bin/ksh`
`/usr/bin/ksh93`	`/usr/bin/pfbash`
`/usr/bin/pfcsh`	`/usr/bin/pfksh`
`/usr/bin/pfksh93`	`/usr/bin/pfsh`
`/usr/bin/pftcsh`	`/usr/bin/pfzsh`
`/usr/bin/sh`	`/usr/bin/tcsh`
`/usr/bin/zsh`	`/usr/sbin/jsh`
`/usr/sbin/pfsh`	`/usr/sbin/sh`
`/usr/sfw/bin/zsh`	`/usr/xpg4/bin/pfsh`
`/usr/xpg4/bin/sh`

The getusershell() function opens the file /etc/shells, if it exists, and returns the next entry in the list of shells.

The setusershell() function rewinds the file or the list.

The endusershell() function closes the file, frees any memory used by getusershell() and setusershell(), and rewinds the file /etc/shells.

Return Values

The getusershell() function returns a null pointer on EOF.

Bugs

All information is contained in memory that may be freed with a call to endusershell(), so it must be copied if it is to be saved.

Notes

Restricted shells should not be listed in /etc/shells.

Copyright © 1993, 2012, Oracle and/or its affiliates. All rights reserved. Legal Notices

Previous

Next