LDP: Update original to LDP v3.79

[linuxjm/LDP_man-pages.git] / original / man3 / strstr.3

diff --git a/original/man3/strstr.3 b/original/man3/strstr.3
index c81183a..7bb5a6a 100644 (file)
--- a/original/man3/strstr.3
+++ b/original/man3/strstr.3
@@ -30,7 +30,7 @@
 .\" Added history, aeb, 980113.
 .\" 2005-05-05 mtk: added strcasestr()
 .\"
-.TH STRSTR 3  2011-09-28 "GNU" "Linux Programmer's Manual"
+.TH STRSTR 3  2015-01-10 "GNU" "Linux Programmer's Manual"
 .SH NAME
 strstr, strcasestr \- locate a substring
 .SH SYNOPSIS
@@ -49,7 +49,9 @@ strstr, strcasestr \- locate a substring
 The
 .BR strstr ()
 function finds the first occurrence of the substring
-\fIneedle\fP in the string \fIhaystack\fP.
+.I needle
+in the string
+.IR haystack .
 The terminating null bytes (\(aq\\0\(aq) are not compared.
 
 The
@@ -59,7 +61,19 @@ function is like
 but ignores the case of both arguments.
 .SH RETURN VALUE
 These functions return a pointer to the beginning of the
-substring, or NULL if the substring is not found.
+located substring, or NULL if the substring is not found.
+.SH ATTRIBUTES
+.SS Multithreading (see pthreads(7))
+The
+.BR strstr ()
+function is thread-safe.
+.LP
+The
+.BR strcasestr ()
+function is thread-safe with exceptions.
+It can be safely used in multithreaded applications, as long as
+.BR setlocale (3)
+is not called to change the locale during its execution.
 .SH CONFORMING TO
 The
 .BR strstr ()
@@ -67,15 +81,22 @@ function conforms to C89 and C99.
 The
 .BR strcasestr ()
 function is a nonstandard extension.
-.SH BUGS
-Early versions of Linux libc (like 4.5.26) would not allow
-an empty \fIneedle\fP argument for
-.BR strstr ().
-Later versions (like 4.6.27) work correctly,
-and return \fIhaystack\fP when \fIneedle\fP is empty.
+.\" .SH BUGS
+.\" Early versions of Linux libc (like 4.5.26) would not allow
+.\" an empty
+.\" .I needle
+.\" argument for
+.\" .BR strstr ().
+.\" Later versions (like 4.6.27) work correctly,
+.\" and return
+.\" .IR haystack
+.\" when
+.\" .I needle
+.\" is empty.
 .SH SEE ALSO
 .BR index (3),
 .BR memchr (3),
+.BR memmem (3),
 .BR rindex (3),
 .BR strcasecmp (3),
 .BR strchr (3),
@@ -85,3 +106,12 @@ and return \fIhaystack\fP when \fIneedle\fP is empty.
 .BR strspn (3),
 .BR strtok (3),
 .BR wcsstr (3)
+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.