.TP
.BR PERF_SAMPLE_WEIGHT " (Since Linux 3.10)"
Records a hardware provided weight value that expresses how
-costly the sampled event was.
+costly the sampled event was.
This allows the hardware to highlight expensive events in
a profile.
.TP
.I wakeup_events
only counts
.B PERF_RECORD_SAMPLE
-record types.
+record types.
To receive a signal for every incoming
.B PERF_RECORD
type set
.I sample_regs_user
attr field.
The number of values is the number of bits set in the
-.I sample_regs_user
+.I sample_regs_user
bitmask.
.TP
.IR size ", " data[size] ", " dyn_size
.I size
).
.TP
-.I weight
+.I weight
If
.B PERF_SAMPLE_WEIGHT
is enabled, then a 64 bit value provided by the hardwre
in profiles.
.TP
.I data_src
-If
+If
.B PERF_SAMPLE_DATA_SRC
is enabled, then a 64 bit value is recorded that is made up of
the following fields:
Enables the individual event or event group specified by the
file descriptor argument.
-If the
+If the
.B PERF_IOC_FLAG_GROUP
-bit is set in the ioctl argument, then all events in a group are
+bit is set in the ioctl argument, then all events in a group are
enabled, even if the event specified is not the group leader.
.TP
.B PERF_EVENT_IOC_DISABLE
affects only that counter; disabling a non-leader
stops that counter from counting but doesn't affect any other counter.
-If the
+If the
.B PERF_IOC_FLAG_GROUP
-bit is set in the ioctl argument, then all events in a group are
+bit is set in the ioctl argument, then all events in a group are
disabled, even if the event specified is not the group leader.
.TP
.B PERF_EVENT_IOC_REFRESH
.I time_running
values.
-If the
+If the
.B PERF_IOC_FLAG_GROUP
-bit is set in the ioctl argument, then all events in a group are
+bit is set in the ioctl argument, then all events in a group are
reset, even if the event specified is not the group leader.
If the
.B PERF_IOC_FLAG_GROUP
bit is not set, then the behavior is somwhat unexpected:
-when sent to a group leader only the leader is reset
-(children are left alone);
+when sent to a group leader only the leader is reset
+(children are left alone);
when sent to a child all events in a group are reset.
.TP
.B PERF_EVENT_IOC_PERIOD
.BR sigsuspend ()
always returns \-1, with
.I errno
-set to inndicate the error (normally,
+set to inndicate the error (normally,
.BR EINTR ).
.SH ERRORS
.TP
Unless
.BR lcong48 ()
is called,
-.IR a
+.IR a
and
.I c
are given by:
.I param[3-5]
specify
.IR a ,
-and
+and
.I param[6]
specifies
.IR c .
by
.IR y .
The return value is
-.IR x
+.IR x
\-
.I n
*
.IR long .
.LP
On many architectures both
-.IR off_t
+.IR off_t
and
.I long
are 32-bit types,
.fi
.in
with
-.IR sigset_t
+.IR sigset_t
and
.I stack_t
defined in
does not exist or
is unreadable,
.BR getusershell ()
-behaves as if
+behaves as if
.I /bin/sh
and
.I /bin/csh
.IR tocode .
.PP
The values permitted for
-.IR fromcode
+.IR fromcode
and
.I tocode
and the supported
combinations are system-dependent.
For the GNU C library, the permitted
-values are listed by the
+values are listed by the
.I "iconv \-\-list"
command, and all combinations
of the listed values are supported.
.TP
.B EINVAL
The conversion from
-.IR fromcode
+.IR fromcode
to
.I tocode
is not supported by the
.PP
If
.I error
-is
+is
.RB \- ERANGE
(\-Infinity),
.RB \- HUGE_VAL
.BR isgreater ()
determines \fI(x)\ >\ (y)\fP without an exception
if
-.IR x
+.IR x
or
.I y
is NaN.
.BR isgreaterequal ()
determines \fI(x)\ >=\ (y)\fP without an exception
if
-.IR x
+.IR x
or
.I y
is NaN.
.BR isless ()
determines \fI(x)\ <\ (y)\fP without an exception
if
-.IR x
+.IR x
or
.I y
is NaN.
.BR islessequal ()
determines \fI(x)\ <=\ (y)\fP without an exception
if
-.IR x
+.IR x
or
.I y
is NaN.
.BR islessgreater ()
determines \fI(x)\ < (y) || (x) >\ (y)\fP
without an exception if
-.IR x
+.IR x
or
.I y
is NaN.
This macro is not equivalent to \fIx\ !=\ y\fP because that expression is
true if
-.IR x
+.IR x
or
.I y
is NaN.
.BR isunordered ()
returns 1 if
-.IR x
+.IR x
or
.I y
is NaN and 0 otherwise.
.PP
The wide-character class "upper" contains at least those characters
.I wc
-which are equal to
+which are equal to
.I towupper(wc)
and different from
.IR towlower(wc) .
.BR localeconv ()
function returns a pointer to a filled in
.IR "struct lconv" .
-This structure may be (in glibc,
+This structure may be (in glibc,
.IR is )
statically allocated, and may be overwritten by subsequent calls.
According to POSIX,
perform a linear search for
.I key
in the array
-.IR base
+.IR base
which has
.I *nmemb
elements of
If the multibyte character is the null wide character, it returns 0.
.PP
If the
-.IR n
+.IR n
bytes starting at
.I s
do not contain a complete multibyte
to the initial state and returns 0.
.PP
If the
-.IR n
+.IR n
bytes starting at
.I s
do not contain a complete multibyte
.fi
.SH DESCRIPTION
The main case for this function is when
-.IR s
+.IR s
is not NULL and
.I pwc
is
to the initial state and returns 0.
.PP
If the
-.IR n
+.IR n
bytes starting at
.I s
do not contain a complete multibyte
are undefined.
.PP
A different case is when
-.IR s
+.IR s
is not NULL but
.I pwc
is NULL.
.I s
is NULL.
In this case,
-.IR pwc
+.IR pwc
and
.I n
are
.BR mbrtowc ()
function is used instead.
Otherwise,
-.IR *ps
+.IR *ps
must be a valid
.I mbstate_t
object.
An
-.IR mbstate_t
+.IR mbstate_t
object
.I a
can be initialized to the initial state
if an invalid multibyte sequence was
encountered.
It returns
-.I "(size_t)\ \-2"
+.I "(size_t)\ \-2"
if it couldn't parse a complete multibyte
character, meaning that
.I n
is returned.
.PP
If
-.IR dest
+.IR dest
is NULL,
.I len
is ignored, and the conversion proceeds as
excluding the terminating null wide character, is returned.
.PP
If
-.IR dest
+.IR dest
is NULL,
.I len
is ignored,
.IR dest .
.PP
If
-.IR dest
+.IR dest
is NULL,
.I n
is ignored, and the conversion proceeds as
.fi
.SH DESCRIPTION
The main case for this function is when
-.IR s
+.IR s
is not NULL and
.I pwc
is
otherwise it returns 0.
.PP
If the
-.IR n
+.IR n
bytes starting at
.I s
do not contain a complete multibyte
if the multibyte string contains redundant shift sequences.
.PP
A different case is when
-.IR s
+.IR s
is not NULL but
.I pwc
is NULL.
.I s
is NULL.
In this case,
-.IR pwc
+.IR pwc
and
.I n
are
.BR memccpy ()
function returns a pointer to the next character
in
-.IR dest
+.IR dest
after
.IR c ,
or NULL if
.BR memmem ()
function finds the start of the first occurrence
of the substring
-.IR needle
+.IR needle
of length
.I needlelen
in the memory
.SH BUGS
This function was broken in Linux libraries up to and including libc 5.0.9;
there the
-.IR needle
+.IR needle
and
.I haystack
arguments were interchanged,
.BR WEOF .
If a wide character
conversion error occurs, it sets
-.IR errno
+.IR errno
to
.B EILSEQ
and returns
.\" not in /usr/include but in a gcc lib
.SH RETURN VALUE
On success, these functions return
-.IR x
+.IR x
*
.B FLT_RADIX
**
.\" not in /usr/include but in a gcc lib
.SH RETURN VALUE
On success, these functions return
-.IR x
+.IR x
*
.B FLT_RADIX
**
.I name
does exist in the environment, then
its value is changed to
-.IR value
+.IR value
if
.I overwrite
is nonzero;
if
-.IR overwrite
+.IR overwrite
is zero, then the value of
.I name
is not
is always null-terminated.
.PP
If
-.IR src
+.IR src
contains
.I n
or more bytes,
.BR strncat ()
-writes
+writes
.I n+1
bytes to
.I dest
or a pointer to the null
byte at the end of
.I s
-(i.e.,
+(i.e.,
.IR "s+strlen(s)" )
if the character is not found.
.SH VERSIONS
.BR strncmp ()
function is similar, except it compares
the only first (at most)
-.IR n
+.IR n
bytes of
.I s1
and
.SH CONFORMING TO
SVr4, 4.3BSD, C89, C99.
.SH NOTES
-In the
+In the
.I "POSIX"
or
.I ""C"
For example, in many locales
.B %p
yields an empty string.
-An empty
+An empty
.I format
string will likewise yield an empty string.
.SH ENVIRONMENT
.BR strstr ().
Later versions (like 4.6.27) work correctly,
and return
-.IR haystack
+.IR haystack
when
.I needle
is empty.
The first call to
.BR strtok ()
sets this pointer to point to the first byte of the string.
-The start of the next token is determined by scanning forward
+The start of the next token is determined by scanning forward
for the next nondelimiter byte in
.IR str .
If such a byte is found, it is taken as the start of the next token.
Thus, for example, given the string "\fIaaa;;bbb,\fP",
successive calls to
.BR strtok ()
-that specify the delimiter string "\fI;,\fP"
+that specify the delimiter string "\fI;,\fP"
would return the strings "\fIaaa\fP" and "\fIbbb\fP",
and then a NULL pointer.
The resulting value was out of range.
.LP
The implementation may also set
-.IR errno
+.IR errno
to
.B EINVAL
in case
The resulting value was out of range.
.LP
The implementation may also set
-.IR errno
+.IR errno
to
.B EINVAL
in case
.SH CONFORMING TO
SVr4, 4.3BSD, C89, C99.
.SH NOTES
-In the
+In the
.IR POSIX
or
.IR C
translates it according to the transliteration descriptor
.IR desc .
If
-.IR wc
+.IR wc
is
.BR WEOF ,
.B WEOF
.BR towctrans ()
function returns the translated wide character,
or
-.BR WEOF
+.BR WEOF
if
.I wc
is
lowercase.
Characters which do not have case are returned unchanged.
If
-.IR wc
+.IR wc
is
.BR WEOF ,
.B WEOF
function returns the lowercase equivalent of
.IR wc ,
or
-.BR WEOF
+.BR WEOF
if
.I wc
is
uppercase.
Characters which do not have case are returned unchanged.
If
-.IR wc
+.IR wc
is
.BR WEOF ,
.B WEOF
function returns the uppercase equivalent of
.IR wc ,
or
-.BR WEOF
+.BR WEOF
if
.I wc
is
These functions return the rounded integer value.
If
-.IR x
+.IR x
is integral, infinite, or NaN,
.I x
itself is returned.
.I wc
is an invalid wide character,
it sets
-.IR errno
+.IR errno
to
.B EILSEQ
and returns
The
.BR ungetwc ()
function returns
-.IR wc
+.IR wc
when successful, or
.B WEOF
upon
returned.
.PP
If
-.IR dest
+.IR dest
is NULL,
.I len
is ignored,
is returned.
.PP
If
-.IR dest
+.IR dest
is NULL,
.I len
is ignored,
.IR dest .
.PP
If
-.IR dest
+.IR dest
is NULL,
.I n
is ignored, and the conversion proceeds as
which can map a wide character to
another wide character.
Its nature is implementation-dependent, but the special
-value
+value
.IR "(wctrans_t)\ 0"
denotes an invalid mapping.
Nonzero
.BR memchr (3)
function.
It searches the
-.IR n
+.IR n
wide characters starting at
.I s
for
function returns a pointer to the first occurrence of
.I c
among the
-.IR n
+.IR n
wide characters starting at
.IR s ,
or NULL if
.BR memcmp (3)
function.
It compares the
-.IR n
+.IR n
wide-characters starting at
.I s1
and the
zero if the wide-character arrays of size
.I n
at
-.IR s1
+.IR s1
and
.I s2
are equal.
buffer overflow on Linux.)
.PP
The treatment of the conversion characters
-.BR c
+.BR c
and
.B s
is different:
A Linux system has up to 63
.I "virtual consoles"
(character devices with major number 4 and minor number 1 to 63),
-usually called
+usually called
.I /dev/ttyn
with 1 \(<=
.I n
.LP
The command
.BR deallocvt (1)
-(formerly
+(formerly
.BR disalloc )
will free the memory taken by the screen buffers for consoles
that no longer have any associated process.
the slave drive is
.BR hdb .
The master drive of the second controller (major device number 22)
-is
+is
.B hdc
and the slave
.BR hdd .
and one stop bit at the speed of 1200 bits/sec.
Data is sent to RxD in 3-byte packets.
The
-.IR dx
+.IR dx
and
.I dy
movements are sent as
null, zero \- data sink
.SH DESCRIPTION
Data written to a
-.BR null
+.BR null
or
.B zero
special file is discarded.
.B VT_GETHIFONTMASK
operation
(available in Linux kernels 2.6.18 and above)
-on
+on
.IR /dev/tty[1\-63] ;
the value is returned in the
.I "unsigned short"
.\" and
.\" .BR lilo.conf (5).)
.\" LILO can boot DOS, OS/2, Linux, FreeBSD, UnixWare, etc., and is quite flexible.
-.\"
+.\"
.\" The other commonly used Linux loader is 'LoadLin', which is a DOS
.\" program that has the capability to launch a Linux kernel from the DOS
.\" prompt (with boot-args) assuming that certain resources are available.
.\" This is good for people that want to launch Linux from DOS.
-.\"
+.\"
.\" It is also very useful if you have certain hardware which relies on
.\" the supplied DOS driver to put the hardware into a known state.
.\" A common example is 'SoundBlaster Compatible' sound cards that require
These days ram disks use the buffer cache, and grow dynamically.
For a lot of information in conjunction with the new ramdisk
setup), see the kernel source file
-.IR Documentation/blockdev/ramdisk.txt
+.IR Documentation/blockdev/ramdisk.txt
.RI ( Documentation/ramdisk.txt
in older kernels).
4.2BSD was released in 1983.
Earlier major BSD releases included
-.IR 3BSD
+.IR 3BSD
(1980),
.I 4BSD
(1980),
projects / thirdparty / man-pages.git / commitdiff
