diff options
Diffstat (limited to '')
| -rw-r--r-- | templates/man2/shmop.2.pot | 1166 |
1 files changed, 1166 insertions, 0 deletions
diff --git a/templates/man2/shmop.2.pot b/templates/man2/shmop.2.pot new file mode 100644 index 00000000..b36220c2 --- /dev/null +++ b/templates/man2/shmop.2.pot @@ -0,0 +1,1166 @@ +# SOME DESCRIPTIVE TITLE +# Copyright (C) YEAR Free Software Foundation, Inc. +# This file is distributed under the same license as the PACKAGE package. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"POT-Creation-Date: 2024-03-01 17:08+0100\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <LL@li.org>\n" +"Language: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. type: TH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "SHMOP" +msgstr "" + +#. type: TH +#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#, no-wrap +msgid "2023-10-31" +msgstr "" + +#. type: TH +#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#, no-wrap +msgid "Linux man-pages 6.06" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "NAME" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "shmat, shmdt - System V shared memory operations" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "LIBRARY" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "Standard C library (I<libc>, I<-lc>)" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "SYNOPSIS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<#include E<lt>sys/shm.hE<gt>>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "" +"B<void *shmat(int >I<shmid>B<, const void *_Nullable >I<shmaddr>B<, int >I<shmflg>B<);>\n" +"B<int shmdt(const void *>I<shmaddr>B<);>\n" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "DESCRIPTION" +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "shmat()" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"B<shmat>() attaches the System\\ V shared memory segment identified by " +"I<shmid> to the address space of the calling process. The attaching address " +"is specified by I<shmaddr> with one of the following criteria:" +msgstr "" + +#. type: IP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "\\[bu]" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"If I<shmaddr> is NULL, the system chooses a suitable (unused) page-aligned " +"address to attach the segment." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"If I<shmaddr> isn't NULL and B<SHM_RND> is specified in I<shmflg>, the " +"attach occurs at the address equal to I<shmaddr> rounded down to the nearest " +"multiple of B<SHMLBA>." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Otherwise, I<shmaddr> must be a page-aligned address at which the attach " +"occurs." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"In addition to B<SHM_RND>, the following flags may be specified in the " +"I<shmflg> bit-mask argument:" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<SHM_EXEC> (Linux-specific; since Linux 2.6.9)" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Allow the contents of the segment to be executed. The caller must have " +"execute permission on the segment." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<SHM_RDONLY>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Attach the segment for read-only access. The process must have read " +"permission for the segment. If this flag is not specified, the segment is " +"attached for read and write access, and the process must have read and write " +"permission for the segment. There is no notion of a write-only shared " +"memory segment." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<SHM_REMAP> (Linux-specific)" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"This flag specifies that the mapping of the segment should replace any " +"existing mapping in the range starting at I<shmaddr> and continuing for the " +"size of the segment. (Normally, an B<EINVAL> error would result if a " +"mapping already exists in this address range.) In this case, I<shmaddr> " +"must not be NULL." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The B<brk>(2) value of the calling process is not altered by the attach. " +"The segment will automatically be detached at process exit. The same " +"segment may be attached as a read and as a read-write one, and more than " +"once, in the process's address space." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"A successful B<shmat>() call updates the members of the I<shmid_ds> " +"structure (see B<shmctl>(2)) associated with the shared memory segment as " +"follows:" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "I<shm_atime> is set to the current time." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "I<shm_lpid> is set to the process-ID of the calling process." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "I<shm_nattch> is incremented by one." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "shmdt()" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"B<shmdt>() detaches the shared memory segment located at the address " +"specified by I<shmaddr> from the address space of the calling process. The " +"to-be-detached segment must be currently attached with I<shmaddr> equal to " +"the value returned by the attaching B<shmat>() call." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"On a successful B<shmdt>() call, the system updates the members of the " +"I<shmid_ds> structure associated with the shared memory segment as follows:" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "I<shm_dtime> is set to the current time." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"I<shm_nattch> is decremented by one. If it becomes 0 and the segment is " +"marked for deletion, the segment is deleted." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "RETURN VALUE" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"On success, B<shmat>() returns the address of the attached shared memory " +"segment; on error, I<(void\\ *)\\ -1> is returned, and I<errno> is set to " +"indicate the error." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"On success, B<shmdt>() returns 0; on error -1 is returned, and I<errno> is " +"set to indicate the error." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "ERRORS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "B<shmat>() can fail with one of the following errors:" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<EACCES>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The calling process does not have the required permissions for the requested " +"attach type, and does not have the B<CAP_IPC_OWNER> capability in the user " +"namespace that governs its IPC namespace." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<EIDRM>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "I<shmid> points to a removed identifier." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<EINVAL>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Invalid I<shmid> value, unaligned (i.e., not page-aligned and B<SHM_RND> was " +"not specified) or invalid I<shmaddr> value, or can't attach segment at " +"I<shmaddr>, or B<SHM_REMAP> was specified and I<shmaddr> was NULL." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<ENOMEM>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "Could not allocate memory for the descriptor or for the page tables." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "B<shmdt>() can fail with one of the following errors:" +msgstr "" + +#. The following since Linux 2.6.17-rc1: +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"There is no shared memory segment attached at I<shmaddr>; or, I<shmaddr> is " +"not aligned on a page boundary." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "STANDARDS" +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +msgid "POSIX.1-2008." +msgstr "" + +#. type: SH +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "HISTORY" +msgstr "" + +#. SVr4 documents an additional error condition EMFILE. +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +msgid "POSIX.1-2001, SVr4." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"In SVID 3 (or perhaps earlier), the type of the I<shmaddr> argument was " +"changed from I<char\\ *> into I<const void\\ *>, and the returned type of " +"B<shmat>() from I<char\\ *> into I<void\\ *>." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "NOTES" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"After a B<fork>(2), the child inherits the attached shared memory segments." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"After an B<execve>(2), all attached shared memory segments are detached from " +"the process." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Upon B<_exit>(2), all attached shared memory segments are detached from the " +"process." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Using B<shmat>() with I<shmaddr> equal to NULL is the preferred, portable " +"way of attaching a shared memory segment. Be aware that the shared memory " +"segment attached in this way may be attached at different addresses in " +"different processes. Therefore, any pointers maintained within the shared " +"memory must be made relative (typically to the starting address of the " +"segment), rather than absolute." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"On Linux, it is possible to attach a shared memory segment even if it is " +"already marked to be deleted. However, POSIX.1 does not specify this " +"behavior and many other implementations do not support it." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "The following system parameter affects B<shmat>():" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<SHMLBA>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Segment low boundary address multiple. When explicitly specifying an attach " +"address in a call to B<shmat>(), the caller should ensure that the address " +"is a multiple of this value. This is necessary on some architectures, in " +"order either to ensure good CPU cache performance or to ensure that " +"different attaches of the same segment have consistent views within the CPU " +"cache. B<SHMLBA> is normally some multiple of the system page size. (On " +"many Linux architectures, B<SHMLBA> is the same as the system page size.)" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The implementation places no intrinsic per-process limit on the number of " +"shared memory segments (B<SHMSEG>)." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "EXAMPLES" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The two programs shown below exchange a string using a shared memory " +"segment. Further details about the programs are given below. First, we " +"show a shell session demonstrating their use." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"In one terminal window, we run the \"reader\" program, which creates a " +"System V shared memory segment and a System V semaphore set. The program " +"prints out the IDs of the created objects, and then waits for the semaphore " +"to change value." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "" +"$ B<./svshm_string_read>\n" +"shmid = 1114194; semid = 15\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"In another terminal window, we run the \"writer\" program. The \"writer\" " +"program takes three command-line arguments: the IDs of the shared memory " +"segment and semaphore set created by the \"reader\", and a string. It " +"attaches the existing shared memory segment, copies the string to the shared " +"memory, and modifies the semaphore value." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "$ B<./svshm_string_write 1114194 15 \\[aq]Hello, world\\[aq]>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Returning to the terminal where the \"reader\" is running, we see that the " +"program has ceased waiting on the semaphore and has printed the string that " +"was copied into the shared memory segment by the writer:" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "Hello, world\n" +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "Program source: svshm_string.h" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The following header file is included by the \"reader\" and \"writer\" " +"programs:" +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"/* svshm_string.h\n" +"\\&\n" +" Licensed under GNU General Public License v2 or later.\n" +"*/\n" +"#include E<lt>sys/types.hE<gt>\n" +"#include E<lt>sys/ipc.hE<gt>\n" +"#include E<lt>sys/shm.hE<gt>\n" +"#include E<lt>sys/sem.hE<gt>\n" +"#include E<lt>stdio.hE<gt>\n" +"#include E<lt>stdlib.hE<gt>\n" +"#include E<lt>string.hE<gt>\n" +"\\&\n" +"#define errExit(msg) do { perror(msg); exit(EXIT_FAILURE); \\e\n" +" } while (0)\n" +"\\&\n" +"union semun { /* Used in calls to semctl() */\n" +" int val;\n" +" struct semid_ds * buf;\n" +" unsigned short * array;\n" +"#if defined(__linux__)\n" +" struct seminfo * __buf;\n" +"#endif\n" +"};\n" +"\\&\n" +"#define MEM_SIZE 4096\n" +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "Program source: svshm_string_read.c" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The \"reader\" program creates a shared memory segment and a semaphore set " +"containing one semaphore. It then attaches the shared memory object into " +"its address space and initializes the semaphore value to 1. Finally, the " +"program waits for the semaphore value to become 0, and afterwards prints the " +"string that has been copied into the shared memory segment by the \"writer\"." +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"/* svshm_string_read.c\n" +"\\&\n" +" Licensed under GNU General Public License v2 or later.\n" +"*/\n" +"#include E<lt>stdio.hE<gt>\n" +"#include E<lt>stdlib.hE<gt>\n" +"#include E<lt>sys/ipc.hE<gt>\n" +"#include E<lt>sys/sem.hE<gt>\n" +"#include E<lt>sys/shm.hE<gt>\n" +"\\&\n" +"#include \"svshm_string.h\"\n" +"\\&\n" +"int\n" +"main(void)\n" +"{\n" +" int semid, shmid;\n" +" char *addr;\n" +" union semun arg, dummy;\n" +" struct sembuf sop;\n" +"\\&\n" +" /* Create shared memory and semaphore set containing one\n" +" semaphore. */\n" +"\\&\n" +" shmid = shmget(IPC_PRIVATE, MEM_SIZE, IPC_CREAT | 0600);\n" +" if (shmid == -1)\n" +" errExit(\"shmget\");\n" +"\\&\n" +" semid = semget(IPC_PRIVATE, 1, IPC_CREAT | 0600);\n" +" if (semid == -1)\n" +" errExit(\"semget\");\n" +"\\&\n" +" /* Attach shared memory into our address space. */\n" +"\\&\n" +" addr = shmat(shmid, NULL, SHM_RDONLY);\n" +" if (addr == (void *) -1)\n" +" errExit(\"shmat\");\n" +"\\&\n" +" /* Initialize semaphore 0 in set with value 1. */\n" +"\\&\n" +" arg.val = 1;\n" +" if (semctl(semid, 0, SETVAL, arg) == -1)\n" +" errExit(\"semctl\");\n" +"\\&\n" +" printf(\"shmid = %d; semid = %d\\en\", shmid, semid);\n" +"\\&\n" +" /* Wait for semaphore value to become 0. */\n" +"\\&\n" +" sop.sem_num = 0;\n" +" sop.sem_op = 0;\n" +" sop.sem_flg = 0;\n" +"\\&\n" +" if (semop(semid, &sop, 1) == -1)\n" +" errExit(\"semop\");\n" +"\\&\n" +" /* Print the string from shared memory. */\n" +"\\&\n" +" printf(\"%s\\en\", addr);\n" +"\\&\n" +" /* Remove shared memory and semaphore set. */\n" +"\\&\n" +" if (shmctl(shmid, IPC_RMID, NULL) == -1)\n" +" errExit(\"shmctl\");\n" +" if (semctl(semid, 0, IPC_RMID, dummy) == -1)\n" +" errExit(\"semctl\");\n" +"\\&\n" +" exit(EXIT_SUCCESS);\n" +"}\n" +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "Program source: svshm_string_write.c" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The writer program takes three command-line arguments: the IDs of the shared " +"memory segment and semaphore set that have already been created by the " +"\"reader\", and a string. It attaches the shared memory segment into its " +"address space, and then decrements the semaphore value to 0 in order to " +"inform the \"reader\" that it can now examine the contents of the shared " +"memory." +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"/* svshm_string_write.c\n" +"\\&\n" +" Licensed under GNU General Public License v2 or later.\n" +"*/\n" +"#include E<lt>stdio.hE<gt>\n" +"#include E<lt>stdlib.hE<gt>\n" +"#include E<lt>string.hE<gt>\n" +"#include E<lt>sys/sem.hE<gt>\n" +"#include E<lt>sys/shm.hE<gt>\n" +"\\&\n" +"#include \"svshm_string.h\"\n" +"\\&\n" +"int\n" +"main(int argc, char *argv[])\n" +"{\n" +" int semid, shmid;\n" +" char *addr;\n" +" size_t len;\n" +" struct sembuf sop;\n" +"\\&\n" +" if (argc != 4) {\n" +" fprintf(stderr, \"Usage: %s shmid semid string\\en\", argv[0]);\n" +" exit(EXIT_FAILURE);\n" +" }\n" +"\\&\n" +" len = strlen(argv[3]) + 1; /* +1 to include trailing \\[aq]\\e0\\[aq] */\n" +" if (len E<gt> MEM_SIZE) {\n" +" fprintf(stderr, \"String is too big!\\en\");\n" +" exit(EXIT_FAILURE);\n" +" }\n" +"\\&\n" +" /* Get object IDs from command-line. */\n" +"\\&\n" +" shmid = atoi(argv[1]);\n" +" semid = atoi(argv[2]);\n" +"\\&\n" +" /* Attach shared memory into our address space and copy string\n" +" (including trailing null byte) into memory. */\n" +"\\&\n" +" addr = shmat(shmid, NULL, 0);\n" +" if (addr == (void *) -1)\n" +" errExit(\"shmat\");\n" +"\\&\n" +" memcpy(addr, argv[3], len);\n" +"\\&\n" +" /* Decrement semaphore to 0. */\n" +"\\&\n" +" sop.sem_num = 0;\n" +" sop.sem_op = -1;\n" +" sop.sem_flg = 0;\n" +"\\&\n" +" if (semop(semid, &sop, 1) == -1)\n" +" errExit(\"semop\");\n" +"\\&\n" +" exit(EXIT_SUCCESS);\n" +"}\n" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "SEE ALSO" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"B<brk>(2), B<mmap>(2), B<shmctl>(2), B<shmget>(2), B<capabilities>(7), " +"B<shm_overview>(7), B<sysvipc>(7)" +msgstr "" + +#. type: TH +#: debian-bookworm +#, no-wrap +msgid "2023-02-05" +msgstr "" + +#. type: TH +#: debian-bookworm +#, no-wrap +msgid "Linux man-pages 6.03" +msgstr "" + +#. SVr4 documents an additional error condition EMFILE. +#. type: Plain text +#: debian-bookworm +msgid "POSIX.1-2001, POSIX.1-2008, SVr4." +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "/* svshm_string.h\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" Licensed under GNU General Public License v2 or later.\n" +"*/\n" +"#include E<lt>sys/types.hE<gt>\n" +"#include E<lt>sys/ipc.hE<gt>\n" +"#include E<lt>sys/shm.hE<gt>\n" +"#include E<lt>sys/sem.hE<gt>\n" +"#include E<lt>stdio.hE<gt>\n" +"#include E<lt>stdlib.hE<gt>\n" +"#include E<lt>string.hE<gt>\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"#define errExit(msg) do { perror(msg); exit(EXIT_FAILURE); \\e\n" +" } while (0)\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"union semun { /* Used in calls to semctl() */\n" +" int val;\n" +" struct semid_ds * buf;\n" +" unsigned short * array;\n" +"#if defined(__linux__)\n" +" struct seminfo * __buf;\n" +"#endif\n" +"};\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "#define MEM_SIZE 4096\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "/* svshm_string_read.c\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" Licensed under GNU General Public License v2 or later.\n" +"*/\n" +"#include E<lt>stdio.hE<gt>\n" +"#include E<lt>stdlib.hE<gt>\n" +"#include E<lt>sys/ipc.hE<gt>\n" +"#include E<lt>sys/sem.hE<gt>\n" +"#include E<lt>sys/shm.hE<gt>\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "#include \"svshm_string.h\"\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"int\n" +"main(void)\n" +"{\n" +" int semid, shmid;\n" +" char *addr;\n" +" union semun arg, dummy;\n" +" struct sembuf sop;\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" /* Create shared memory and semaphore set containing one\n" +" semaphore. */\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" shmid = shmget(IPC_PRIVATE, MEM_SIZE, IPC_CREAT | 0600);\n" +" if (shmid == -1)\n" +" errExit(\"shmget\");\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" semid = semget(IPC_PRIVATE, 1, IPC_CREAT | 0600);\n" +" if (semid == -1)\n" +" errExit(\"semget\");\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid " /* Attach shared memory into our address space. */\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" addr = shmat(shmid, NULL, SHM_RDONLY);\n" +" if (addr == (void *) -1)\n" +" errExit(\"shmat\");\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid " /* Initialize semaphore 0 in set with value 1. */\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" arg.val = 1;\n" +" if (semctl(semid, 0, SETVAL, arg) == -1)\n" +" errExit(\"semctl\");\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid " printf(\"shmid = %d; semid = %d\\en\", shmid, semid);\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid " /* Wait for semaphore value to become 0. */\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" sop.sem_num = 0;\n" +" sop.sem_op = 0;\n" +" sop.sem_flg = 0;\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" if (semop(semid, &sop, 1) == -1)\n" +" errExit(\"semop\");\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid " /* Print the string from shared memory. */\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid " printf(\"%s\\en\", addr);\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid " /* Remove shared memory and semaphore set. */\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" if (shmctl(shmid, IPC_RMID, NULL) == -1)\n" +" errExit(\"shmctl\");\n" +" if (semctl(semid, 0, IPC_RMID, dummy) == -1)\n" +" errExit(\"semctl\");\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" exit(EXIT_SUCCESS);\n" +"}\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "/* svshm_string_write.c\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" Licensed under GNU General Public License v2 or later.\n" +"*/\n" +"#include E<lt>stdio.hE<gt>\n" +"#include E<lt>stdlib.hE<gt>\n" +"#include E<lt>string.hE<gt>\n" +"#include E<lt>sys/sem.hE<gt>\n" +"#include E<lt>sys/shm.hE<gt>\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"int\n" +"main(int argc, char *argv[])\n" +"{\n" +" int semid, shmid;\n" +" char *addr;\n" +" size_t len;\n" +" struct sembuf sop;\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" if (argc != 4) {\n" +" fprintf(stderr, \"Usage: %s shmid semid string\\en\", argv[0]);\n" +" exit(EXIT_FAILURE);\n" +" }\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" len = strlen(argv[3]) + 1; /* +1 to include trailing \\[aq]\\e0\\[aq] */\n" +" if (len E<gt> MEM_SIZE) {\n" +" fprintf(stderr, \"String is too big!\\en\");\n" +" exit(EXIT_FAILURE);\n" +" }\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid " /* Get object IDs from command-line. */\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" shmid = atoi(argv[1]);\n" +" semid = atoi(argv[2]);\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" /* Attach shared memory into our address space and copy string\n" +" (including trailing null byte) into memory. */\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" addr = shmat(shmid, NULL, 0);\n" +" if (addr == (void *) -1)\n" +" errExit(\"shmat\");\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid " memcpy(addr, argv[3], len);\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid " /* Decrement semaphore to 0. */\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" sop.sem_num = 0;\n" +" sop.sem_op = -1;\n" +" sop.sem_flg = 0;\n" +msgstr "" + +#. type: TH +#: debian-unstable opensuse-tumbleweed +#, no-wrap +msgid "2023-05-03" +msgstr "" + +#. type: TH +#: debian-unstable opensuse-tumbleweed +#, no-wrap +msgid "Linux man-pages 6.05.01" +msgstr "" + +#. type: TH +#: opensuse-leap-15-6 +#, no-wrap +msgid "2023-03-30" +msgstr "" + +#. type: TH +#: opensuse-leap-15-6 +#, no-wrap +msgid "Linux man-pages 6.04" +msgstr "" |